Monitor events API
Events from the team's monitors, newest first (the same events the webhooks deliver).
GET /v1/monitors/events
GET /v1/monitors/events
Events from the team's monitors, newest first (the same events the webhooks deliver).
- Cost: Free
- Cache: Not cached.
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
monitor_id | string | no | Only this monitor's events. |
Every request also accepts:
cursor: the cursor from the previous page (Pagination).
Example request#
Set your key in the environment first (see Authentication).
1curl "https://api.socialscrape.dev/v1/monitors/events" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY"1import os2import requests34res = requests.get(5 "https://api.socialscrape.dev/v1/monitors/events",6 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},7)8body = res.json()910if body["ok"]:11 print(body["data"])12else:13 print(body["error"]["code"], body["error"]["message"])1const res = await fetch("https://api.socialscrape.dev/v1/monitors/events", {2 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },3});4const body = await res.json();56if (body.ok) {7 console.log(body.data);8} else {9 console.error(body.error.code, body.error.message);10}1{2 "nodes": [3 {4 "name": "SocialScrape Monitor events",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/monitors/events",14 "sendQuery": false,15 "sendHeaders": true,16 "headerParameters": {17 "parameters": [18 {19 "name": "x-api-key",20 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"21 }22 ]23 }24 }25 }26 ],27 "connections": {}28}Example response#
This is a sample with illustrative values. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 0,4 "credits_remaining": 5000,5 "cached": false,6 "cached_at": null,7 "request_id": "req_900021adf2c0e4ad62cf5d03",8 "data": {9 "object": "list",10 "items": [11 {12 "object": "monitor_event",13 "id": "evt_0123456789abcdef",14 "monitor_id": "mon_0123456789abcdef",15 "type": "new_items",16 "items": [17 {18 "object": "repo",19 "platform": "github",20 "id": "2325298",21 "url": "https://github.com/torvalds/linux",22 "name": "linux",23 "full_name": "torvalds/linux"24 }25 ],26 "created_at": "2026-10-29T15:00:02Z"27 }28 ],29 "cursor": null,30 "has_more": false31 },32 "cursor": null,33 "has_more": false34}Response#
A list of MonitorEvent objects in data.items, with data.cursor and data.has_more.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints#
- Create a monitor (
POST /v1/monitors) - List monitors (
GET /v1/monitors) - Delete a monitor (
DELETE /v1/monitors/{monitor_id}) - Send a test event (
POST /v1/monitors/{monitor_id}/test) - Webhook delivery log (
GET /v1/monitors/{monitor_id}/deliveries) - Send an event again (
POST /v1/monitors/events/{event_id}/redeliver)