API Documentation

Drop-in Instagram feed endpoint for your website or app.

Authentication

Pass your dashboard API key on every request.

x-api-key: sk_...

GET /api/public/posts/{userId}

Returns recent Instagram media for the account linked to the API key. Query param limit defaults to 25.

curl -H "x-api-key: sk_YOUR_KEY" \
  https://YOUR_DOMAIN/api/public/posts/YOUR_USER_ID?limit=12

{
  "data": [
    {
      "id": "...",
      "caption": "...",
      "media_type": "IMAGE",
      "media_url": "https://...",
      "thumbnail_url": "https://...",
      "permalink": "https://instagram.com/p/...",
      "timestamp": "2024-01-15T10:30:00+0000"
    }
  ],
  "paging": {}
}

Errors

401 — missing or invalid API key

404 — Instagram not connected

500 — Instagram Graph API failure

Full contract: docs/API.md in the repository. Create an API key.