Monitors

Manually trigger a monitor poll

Manually trigger a monitor poll outside its schedule.

POST/v1/monitors/{id}/trigger
0credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
idstringrequiredpath

Monitor identifier.

min 1 chars

Response fields
7

Endpoint-specific response payload.

datatriggered
boolean

Always true when the manual poll was accepted and enqueued.

one of: true

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/monitors/abc123/trigger" \
  -H "x-api-key: YOUR_API_KEY" \
  -X POST

Responses

Manual poll accepted and enqueued.