Social Fetch
Instagram

Get Instagram post transcript

Get the transcript for an Instagram post or Reel.

Operation

GET/v1/instagram/posts/transcript
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Link to the Instagram post or Reel whose transcript should be returned.

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the media could be resolved for transcription.

one of: found, not_found

datapost
objectrequirednullable

Post or Reel identity when the lookup resolved; otherwise null.

dataposturl
stringrequired

Public Instagram URL that was requested.

min 1 chars

datatranscripts
arrayrequired

Transcript rows for the resolved media. Carousel posts may return more than one row when transcript data is available for multiple video items.

datatranscripts[]id
stringrequired

Instagram media id for this transcript row.

min 1 chars

datatranscripts[]shortcode
stringrequired

Public shortcode for the media item in this transcript row.

min 1 chars

datatranscripts[]text
stringrequirednullable

Plain transcript text when available. Null means no transcript text was returned for this media item.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Transcript lookup result. Inspect `data.lookupStatus` for found and not-found outcomes.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page