Skip to documentation
Browse documentation

Search Topic

Searches Instagram's public popular-content surface for a known explore topic slug, ID, or topic URL.

Capability ID instagram.topic.search
Cost 1 credit per request
Maximum runtime 60 seconds
View raw

POST /execute Shared execution endpoint

Input parameters

cursor string optional

Opaque next_cursor from a previous response

limit integer optional

Maximum deduplicated results

Example 12
max_pages integer optional

Maximum upstream pages for this request

topic string required

Known topic ID, topic slug, explore-topic URL, or public /popular/ URL

Example travel

Response

Successful output is returned in results[0].data. Raw platform output is intentionally open-ended and may evolve with the upstream source.

Illustrative sample The full redacted fixture is shown in the response panel.

Illustrative output fields

Derived from the sample above for orientation only. These observed fields are not a fixed response schema.

PathObserved typeExample
category string Sports
has_more boolean true
next_cursor string [redacted:token]
pages integer 1
posts array 3 items
posts array 3 items
topic_id string 1283274535024498
topic_name string Sports
topic_slug string sports
total_count integer 12

Execution behavior

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until the job reaches completed or failed.