> Full API reference: https://docs.scrapecreators.com/llms.txt

# Facebook - Transcript

Returns the transcript text for a Facebook video post or reel. Existing transcripts or native captions are used first and cost 1 credit only when returned. Otherwise the public video is transcribed using AI. No transcript costs 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.

**Base URL:** `https://api.scrapecreators.com`

**Endpoint:** `GET /v1/facebook/post/transcript`

**Authentication:** Pass your API key via the `x-api-key` header.

**Credits:** Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits

## API Specification

````yaml get /v1/facebook/post/transcript
openapi: 3.1.0
info:
  title: Scrape Creators API
  description: >-
    The Scrape Creators API - the easiest way to scrape public social
    media data at scale.
  version: 1.0.0
  contact:
    name: Scrape Creators
    url: https://scrapecreators.com
servers:
  - url: https://api.scrapecreators.com
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: "Facebook"
    description: "Get public Facebook profiles and posts"
paths:
  /v1/facebook/post/transcript:
    get:
      tags:
        - "Facebook"
      summary: "Transcript"
      description: "Returns the transcript text for a Facebook video post or reel. Existing transcripts or native captions are used first and cost 1 credit only when returned. Otherwise the public video is transcribed using AI. No transcript costs 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."
      parameters:
        - name: allow_long_transcription
          in: query
          required: false
          description: "Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."
          schema:
            type: boolean
        - name: url
          in: query
          required: true
          description: "Facebook post URL"
          schema:
            type: string
        - name: cache_max_age
          in: query
          required: false
          description: "If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"
          schema:
            type: string
            enum:
              - "1d"
              - "3d"
              - "7d"
              - "14d"
              - "30d"
          example: "7d"
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  duration_seconds:
                    type: number
                    description: "Present only when an AI transcript is returned: media duration in seconds. For Instagram carousels, this is the total (sum) duration of successfully transcribed videos. Only paid mode rounds each video's billable minutes separately; default carousel pricing stays flat at 1 credit per request."
                  duration_minutes:
                    type: number
                    description: "Present only when an AI transcript is returned: duration_seconds / 60 rounded to two decimal places, not the rounded-up billable minutes in paid mode. Default successful short AI remains 1 credit per request. Use credits_charged for the actual charge."
              example: |
                {
                  "success": true,
                  "credits_remaining": 49999939403,
                  "transcript": "We're fishing\nbite x2\nBest bait\non this pole\nsomething else\nThere's a chance\ncan get a\nmythic pistol\nYou have to\nall game\nstill won't\nNuh uh\nliterally\nthe spawn\non it\n1 in 1000\nlike that\nWell watch\nright here\nGonna do it\nstream\nto finding\npistol\nto still lose with it\nThat was very\nvery much\nhoney\nthank you very much"
                }
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Scrape Creators API key.
````