Search Instagram Popular topics

Search Instagram's curated Popular topics by keyword.

GET/v1/instagram/search/popular
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

Search query text for Instagram Popular topics.

min 1 chars · max 512 chars

cursorstringoptionalquery

Pagination cursor returned by a previous response.

min 1 chars

Response fields
35

Endpoint-specific response payload.

dataquery
string

Popular topic that was evaluated for this response.

datatitle
stringnullable

Topic title from the first page. Null on later pages.

datatotalMediaCount
integernullable

Numeric total media count for the topic on the first page. Null on later pages.

≥ 0

Generated topic description and sources on the first page. Null on later pages.

datadescriptionplainText
stringnullable

Generated topic description when Instagram provides one.

Source URLs cited for the generated topic description.

datadescriptionsourceUris[]
stringoptional

min 1 chars

Linked topic terms from the generated description.

datadescriptionlinkedTerms[]
stringoptional

min 1 chars

Suggested related terms on the first page. Null on later pages.

datasuggestedTerms[]
stringoptional

min 1 chars

Instagram posts curated for this Popular topic.

dataposts[]id
string

Instagram media id for this post.

min 1 chars

dataposts[]shortcode
string

Public shortcode used in the Instagram post URL.

min 1 chars

dataposts[]url
string

Canonical public Instagram URL for this post.

min 1 chars

dataposts[]type
stringnullable

Instagram media type for this item when provided, such as reel.

dataposts[]caption
stringnullable

Caption text when Instagram provides one.

dataposts[]displayUrl
stringnullable

Primary display image URL when available.

dataposts[]videoUrl
stringnullable

Direct video URL when a playable URL is available.

Engagement metrics when Instagram exposes them.

dataposts[]metricsplays
integernullable

Play count when Instagram exposes it.

≥ 0

Post owner metadata when Instagram exposes it.

dataposts[]ownerplatformUserId
stringnullable

Instagram numeric user id for the post owner when present.

dataposts[]ownerhandle
stringnullable

Instagram username for the post owner when present.

dataposts[]ownerverified
booleannullable

Whether Instagram marks the post owner as verified.

dataposts[]owneravatarUrl
stringnullable

Profile image URL for the post owner when present.

Pagination state for the current response.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/instagram/search/popular?query=music" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Popular topic posts for the requested query.