Search Instagram posts and reels
Find public Instagram posts and reels by keyword and retrieve each match with its media URLs, caption, author, timestamps and engagement counters. Results are ordered by relevance. Use trim for compact records and pass the returned cursor to retrieve another result page.
/v1/instagram/search/postsx-api-keyHeaders
Get your API keyYour ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.
Keyword or phrase to find in public Instagram posts and reels; 1–300 characters.
min 1 chars · max 300 chars
meal prepContinuation cursor returned by the previous response (engine and page, for example atlas:2), or null when there is no next page. Pass the value unchanged to request another page.
true returns each post in the compact projection of Get an Instagram post or reel with trim=true.
one of: true, false
Request correlation identifier.
HTTP attempts, decoded bytes and duration for post discovery and the Instagram post reads (one media document per post, plus the logged-out post document for carousels; the logged-out post document alone while Instagram refuses the media document).
Always included.
≥ 0
Always included.
≥ 0
Always included.
≥ 0
True when usable data is returned; inspect status and coverage for omissions.
success, partial, failed, or challenged. HTTP 200 can be partial.
one of: success, partial
Search index URL used to discover the returned posts.
absolute HTTPS URL
UTC retrieval time.
The source is web_search and the order is relevance. web_index_selection is always present (status partial); posts_omitted when an indexed post is no longer public; post_reads_stopped when Instagram refused further reads and the posts read before are returned; web_index_fallback when the first index page held no post or reel link and the next index served the posts; post_details_partial when one or more posts were read from the logged-out post layout (see Get an Instagram post or reel).
Always included.
Always included.
Always included.
Always included.
Keyword or phrase to find in public Instagram posts and reels; 1–300 characters.
min 1 chars
Up to 10 matching public posts and reels per page, each in the layout of Get an Instagram post or reel without comments (comment counts stay; comment edges are empty).
up to 10 items
Always included.
Always included.
min 1 chars
Always included.
one of: XDTGraphImage, XDTGraphVideo, XDTGraphSidecar
Always included.
Always included.
Always included.
Always included.
min 1 chars
Always included.
Always included.
absolute HTTPS URL
Continuation cursor returned by the previous response (engine and page, for example atlas:2), or null when there is no next page. Pass the value unchanged to request another page.
No fields match.
HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.
| HTTP | failure.code | Meaning |
|---|---|---|
| 400 | invalid_request | Missing, duplicate, malformed or unsupported parameters, handles, ids, cursors or URLs. |
| 401 | unauthorized | Invalid API key. |
| 404 | not_found | Unknown handle, user id, post, or a keyword without a popular page. |
| 403 | restricted_page | The page or document is private or gated (private account, gated media, login redirect). |
| 422 | count_estimated_only | Instagram abbreviates this post count and allow_estimated was not set. |
| 429 | upstream_rate_limited | Instagram rate limited the page load or the GraphQL read. |
| 502 | upstream_challenged | Instagram refused the request with its error shell (status challenged). |
| 502 | operation_unavailable | Instagram no longer serves the pinned document for this operation. |
| 502 | unsafe_redirect | Instagram redirected the request somewhere other than the login form. |
| 502 | unsupported_page | The page or GraphQL result is missing, mismatched or structurally unsupported. |
| 502 | response_too_large | The decoded responses exceeded the operation's byte budget (1–5 MiB). |
| 502 | payload_too_complex | The response exceeded the JSON depth or node limits. |
| 502 | request_limit | The upstream request budget was exhausted. |
| 502 | search_failed | The search index did not answer, or no indexed post could be read. |
| 502 | upstream_error | Network failure or HTTP 5xx after the single retry. |
| 503 | search_unavailable | Keyword search has no search index configured. |
| 503 | busy | All retrieval slots are busy. |
| 504 | timeout | The 45-second deadline elapsed. |