herascrape
Menu
API reference

Instagram Top Search API

GET/search/top

Blended top search — heterogeneous result units returned as Instagram sends them.

$0.0004 per request ($0.40 per 1,000), flat. Only successful calls are billed.

Parameters

NameInRequiredDescription
search_session_idqueryyesClient-created UUID reused for one search journey
serp_session_idqueryyesClient-created UUID reused for one SERP journey
queryqueryyesSearch query
cursorquerynoPagination cursor from next_cursor

Request

curl "https://api.herascrape.com/search/top?search_session_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890&serp_session_id=f0e1d2c3-b4a5-6789-0abc-def123456789&query=nasa" \
  -H "x-api-key: $HERASCRAPE_KEY"

Returns one page of results in the uniform `{ items, next_cursor, has_more }` envelope. Loop on `next_cursor` to page through the rest.