API
One REST API.
Every Fomo signal.
Base URL
https://fomodata.dev/v1Versioned under /v1. Breaking changes ship as a new version. Versioning
Authentication
Authorization: Bearer $FOMODATA_API_KEYfd_test_… keys return labelled sandbox data right after sign-up. fd_live_… keys are for approved projects.
TypeScript SDK
npm install https://fomodata.dev/npm package coming soon. This installs the same build from this server.
Typed from the OpenAPI document. Retries, pagination, webhooks and streams built in. SDK docs
First call
Paste it. Run it.
Every sample on this site targets https://fomodata.dev/v1 and works as pasted with your key in FOMODATA_API_KEY. Sandbox handles start with @sbx_.
curl 'https://fomodata.dev/v1/profiles/@sbx_milo' \
-H "Authorization: Bearer $FOMODATA_API_KEY"Endpoints
25 endpoints, one shape.
Theses
3Tokens
3Webhooks
9- POST
/v1/webhook-deliveries/{id}/replayReplay a delivery - GET
/v1/webhooksList webhook endpoints - POST
/v1/webhooksCreate a webhook endpoint - GET
/v1/webhooks/{id}Retrieve a webhook endpoint - PATCH
/v1/webhooks/{id}Update a webhook endpoint - DELETE
/v1/webhooks/{id}Delete a webhook endpoint - GET
/v1/webhooks/{id}/deliveriesList deliveries for a webhook - POST
/v1/webhooks/{id}/rotate-secretRotate the signing secret - POST
/v1/webhooks/{id}/testSend a test event
Rate-limit headers
- X-RateLimit-Limit
- Requests allowed in the current window for this endpoint class.
- X-RateLimit-Remaining
- Requests left in the window.
- X-RateLimit-Reset
- Unix time (seconds) when the window resets.
- Retry-After
- On 429 and 503: seconds to wait before retrying.
- X-FomoData-Request-Id
- Unique id for the request. Quote it to support.
Per-minute limits answer 429 RATE_LIMITED; the monthly quota answers 429 QUOTA_EXCEEDED. Limits per plan
For tools and agents
- OpenAPI 3.1 documentImport into Postman, Insomnia or Bruno: Import, then Link, then paste this URL.
- llms.txtA compact, machine-readable summary of the API for AI agents and coding assistants.
- GET fomodata.dev/v1Discovery JSON: docs, reference, OpenAPI, SDK install and the current WebSocket URL.
Realtime: WebSocket at wss://visits-taking-trademark-corner.trycloudflare.com/v1/stream, plus Server-Sent Events at /v1/events/stream. Streams