Get Instagram Post Transcripts

Transcribe a bounded list of Instagram video posts by shortcode and return one item per requested shortcode with per-item success or error details. Successful items include the raw post-page data used for transcription.

Note: Batch transcription is capped at 10 shortcodes per request. API-key and OAuth calls are charged only for successful items; x402 and MPP use the advertised request price.

Pricing: 5 credits per transcript ($0.05)

POST /v1/raw/instagram/transcripts

cURL

cURL

curl --request POST \
  --url https://api.influship.com/v1/raw/instagram/transcripts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "shortcodes": [
    "C0ABC123xyz",
    "D1DEF456uvw"
  ]
}
'

import Influship from 'influship';

const client = new Influship({
  apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

const response = await client.raw.instagram.getTranscripts({
  shortcodes: ['C0ABC123xyz', 'D1DEF456uvw'],
});

console.log(response.data);

import os
from influship import Influship

client = Influship(
    api_key=os.environ.get("INFLUSHIP_API_KEY"),  # This is the default and can be omitted
)
response = client.raw.instagram.get_transcripts(
    shortcodes=["C0ABC123xyz", "D1DEF456uvw"],
)
print(response.data)

200

{
  "data": {
    "requested": 123,
    "succeeded": 123,
    "failed": 123,
    "items": [
      {
        "success": true,
        "shortcode": "<string>",
        "data": {
          "shortcode": "<string>",
          "transcript": "<string>",
          "full_text": "<string>",
          "word_count": 123,
          "language": "<string>",
          "scraped_at": "2023-11-07T05:31:56Z",
          "post": {
            "id": "<string>",
            "shortcode": "<string>",
            "display_url": "<string>",
            "is_video": true,
            "like_count": 123,
            "comment_count": 123,
            "caption": "<string>",
            "taken_at": 123,
            "owner_username": "<string>",
            "accessibility_caption": "<string>",
            "video_url": "<string>",
            "thumbnail_url": "<string>",
            "view_count": 123,
            "carousel_items": [
              {
                "index": 123,
                "display_url": "<string>",
                "is_video": true,
                "video_url": "<string>",
                "thumbnail_url": "<string>"
              }
            ],
            "coauthor_usernames": [
              "<string>"
            ],
            "is_paid_partnership": true,
            "sponsor_usernames": [
              "<string>"
            ],
            "tagged_usernames": [
              "<string>"
            ],
            "product_mentions": [
              {
                "product_id": "<string>",
                "product_name": "<string>",
                "merchant_username": "<string>"
              }
            ],
            "display_resources": [
              {
                "src": "<string>",
                "config_width": 123,
                "config_height": 123
              }
            ],
            "video_versions": [
              {
                "url": "<string>",
                "id": "<string>",
                "type": 123,
                "width": 123,
                "height": 123
              }
            ],
            "music_attribution": {
              "artist_name": "<string>",
              "song_name": "<string>",
              "audio_id": "<string>",
              "uses_original_audio": true,
              "should_mute_audio": true
            },
            "location": {
              "id": "<string>",
              "name": "<string>",
              "slug": "<string>",
              "has_public_page": true,
              "lat": 123,
              "lng": 123,
              "address_json": {}
            },
            "is_pinned": true,
            "engagement_visibility": {
              "viewer_can_reshare": true,
              "comments_disabled": true,
              "like_and_view_counts_disabled": true
            }
          },
          "duration_seconds": 123
        }
      }
    ],
    "scraped_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

Authorizations

X-API-Key · string · header · required

Body

application/json

shortcodes · string[] · required

Instagram video post shortcodes from /p/, /reel/, or /tv/ URLs

Required array length: 1 - 10 elements

Minimum string length: 1

Example:

["C0ABC123xyz", "D1DEF456uvw"]

language · string

Optional language code for transcription. Omit to auto-detect.

Example:

"en"

Response

200

application/json

Successful response

data · object · required

Show child attributes