Monitors

List watchable sources

List Social Fetch operations that can be watched by a monitor.

GET/v1/monitors/sources
0credits
x-api-keystringheader

API key (`sfk_...`)

Response fields
28

Endpoint-specific response payload.

Every watchable public API source, in display order.

datasources[]operationId
string

Public API operation id this source watches.

datasources[]displayName
string

Human name shown in the monitor-creation wizard.

datasources[]mode
string

How new items are detected for this source: `feed` diffs by id-set plus a timestamp watermark; `search` diffs by id-set only.

one of: feed, search

datasources[]defaultIntervalMinutes
integer

Suggested default polling interval in minutes.

≥ 0

datasources[]minIntervalMinutes
integer

Minimum polling interval allowed for this source.

≥ 0

datasources[]docsTitle
string

Full sentence title for this operation.

datasources[]inputHint
stringoptional

Optional qualifier shown next to the display name.

Illustrative sample event envelope showing the shape a real webhook delivery for this source would have.

datasources[]sampleEventid
string

Identifier for the sample event.

datasources[]sampleEventapiVersion
string

Monitor event envelope schema version.

datasources[]sampleEventtype
string

Event type, e.g. `webhook_endpoint.test`.

datasources[]sampleEventcreatedAt
string

ISO-8601 timestamp for when the sample event was built.

Monitor identity the event is attributed to.

datasources[]sampleEventmonitorid
string

Monitor id (`sample` for illustrative events).

datasources[]sampleEventmonitorname
string

Monitor display name.

Source operation and params for this event.

datasources[]sampleEventsourceoperationId
string

Watchable public API operation for this source.

datasources[]sampleEventsourceparams
object

Parameters used for the poll that produced this event.

datasources[]sampleEventdata
object

Event payload. Shape depends on the source.

Billing details for this event.

datasources[]sampleEventbillingcreditsCharged
integer

Credits charged for the poll that produced this event.

≥ 0

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/sources" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Every public API operation Monitors can watch.