Posts found by Instagram's keyword search, including posts that never used the word as a hashtag.
| parameter | type | description |
|---|---|---|
| query | string, required | The keyword, hashtag, place, id or URL this endpoint reads. |
| limit | integer | Items per page, up to 50 synchronously. Above that the call becomes a job. |
| cursor | string | meta.next_cursor from the previous page. |
| fresh | boolean | Skip the stored copy and read live, at the same price. |
| fields | string | Comma-separated field paths to keep. |
| format | json, csv | CSV flattens each item to one row. |
1 credit per result. Failed calls are never charged, and empty results are free up to 25 a day. Stored copies are age-aware, 15 minutes to 7 days.
curl "https://api.instadata.dev/v1/instagram/keyword-search?query=home%20workout&limit=10" \ -H "Authorization: Bearer ik_live_..."
{
"data": [ … ],
"meta": { "count": …, "limit": …, "next_cursor": "…" },
"request_id": "req_01J…"
}