Transcript

GET/v2/instagram/media/transcript1 credit

Transcribes the speech in a reel or video post to text with AI. A carousel gets one transcript per video.

01Query parameters

Name	Type	Description
urlrequired	string	Link to the reel or video post (`/p/…`, `/reel/…` or `/tv/…`).
allow_long_transcriptionoptional	boolean	Set to `true` to transcribe videos longer than 120 seconds, priced per minute (see Pricing).Default: `false`
cache_max_ageoptional	string	Accepted for compatibility. Every call is fetched fresh, so any allowed value gives the same live answer; any other value is a free 400.Accepted values:`1d3d7d14d30d`

02Pricing

1 credit per call for videos up to 120 seconds. With `allow_long_transcription=true`, 10 credits per started minute of every transcribed video, short ones included. Videos without speech cost nothing in either mode.

03Request

curl "https://api.scrapesocial.ai/v2/instagram/media/transcript?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDecPSQfoaRe%2F" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v2/instagram/media/transcript?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDecPSQfoaRe%2F

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "transcripts": [
    {
      "id": "4007144993811702878",
      "shortcode": "DecPSQfoaRe",
      "text": "Our seas are under pressure. What happens if we don't have any corals anymore? We don't have the fish that rely on them. If we lose them, we're going to care a lot. It's not the time to give up. Everything is unique there. It's full of surprises. It worked. I am so excited. Working together with coastal communities, these explorers help us to reimagine our world. There, there, there, there. As one…"
    }
  ],
  "duration_seconds": 30.114,
  "duration_minutes": 0.5
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

05Notes

`transcripts` holds `id`, `shortcode` and `text` per video, plus `duration_seconds` and `duration_minutes`. A video without speech has `text: null`. A post without any video is a free 404, a URL that is not a post a free 400, and a video over 120 seconds without `allow_long_transcription=true` a free 400.

06Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.