Retrieve widget configurations and embed data programmatically. Requires a Pro or Agency plan.
Bearer Auth
All requests authenticated with ff_live_ prefixed keys.
60s cache
Responses cached 60s at edge. Ideal for server-side rendering.
JSON only
All endpoints return application/json. No XML.
Include your API key in the Authorization header:
Authorization: Bearer ff_live_<your_key>
Manage keys at /settings/api-keys. Never expose keys in client-side code.
/api/v1/widgets/{id}Returns a widget's config and metadata.
Request
curl -H "Authorization: Bearer ff_live_…" \ https://feedflow.io/api/v1/widgets/clx123abc
Response 200
{
"id": "clx123abc",
"name": "My Instagram Feed",
"type": "INSTAGRAM_FEED",
"config": { "columns": 3, "rows": 3, "showCaption": true },
"isPublished": true,
"embedCount": 42,
"allowedDomains": ["example.com"],
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-04-28T08:30:00.000Z"
}Error responses
| 401 | Missing, invalid, or revoked API key |
| 404 | Widget not found or not owned by this key |
| Plan | Requests / min | Requests / day |
|---|---|---|
| Pro | 60 | 10,000 |
| Agency | 300 | 100,000 |
Rate limits are enforced per API key. Exceeding the limit returns 429 Too Many Requests.
The Agency plan supports 300 req/min. For enterprise volumes, contact us.