Skip to main content
POST
/
instagram
/
video
/
metadata
Instagram Video Metadata
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/instagram/video/metadata \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://www.instagram.com/reels/DLlGZiCOBQ0/",
  "channel": "apify"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "data": {
      "xdt_shortcode_media": {
        "__typename": "XDTGraphVideo",
        "id": "3667365614373573684",
        "shortcode": "DLlGZiCOBQ0",
        "thumbnail_src": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-15/...",
        "dimensions": {
          "height": 1136,
          "width": 640
        },
        "display_url": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-15/...",
        "display_resources": [
          {
            "src": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-15/...",
            "config_width": 640,
            "config_height": 1136
          }
        ],
        "dash_info": {
          "is_dash_eligible": true,
          "video_dash_manifest": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>...",
          "number_of_qualities": 1
        },
        "has_audio": true,
        "video_url": "https://scontent-jnb2-1.cdninstagram.com/o1/v/t2/f2/m86/...",
        "video_view_count": 27040,
        "video_play_count": 1799817,
        "product_type": "clips",
        "video_duration": 41.125,
        "clips_music_attribution_info": {
          "artist_name": "humansofny",
          "song_name": "Original audio",
          "uses_original_audio": true,
          "audio_id": "24313369781619226"
        },
        "is_video": true,
        "owner": {
          "id": "242598499",
          "username": "humansofny",
          "is_verified": true,
          "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-19/...",
          "full_name": "Humans of New York",
          "edge_followed_by": {
            "count": 12804266
          }
        },
        "edge_media_to_caption": {
          "edges": [
            {
              "node": {
                "text": "I have the moves that they're looking for.",
                "created_at": "1751404145"
              }
            }
          ]
        },
        "edge_media_to_parent_comment": {
          "count": 487,
          "edges": [
            {
              "node": {
                "id": "18094151056886709",
                "text": "Go for it sweetie!!!",
                "created_at": 1762011704,
                "owner": {
                  "username": "iam_carrongrazette"
                }
              }
            }
          ]
        },
        "edge_media_preview_like": {
          "count": 27791
        },
        "taken_at_timestamp": 1751404144
      }
    },
    "extensions": {
      "is_final": true
    },
    "status": "ok"
  },
  "failed": false,
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

Product: Visual Intelligence — Social Media Scraping Use case: Fetch video metadata, transcripts, captions, and comments from YouTube, Instagram, TikTok, and Twitter/X Host: https://mavi-backend.memories.ai/serve/api/v2 Auth: Authorization: sk-mavi-... (no Bearer prefix)
This endpoint allows you to retrieve metadata for an Instagram video.
Channel routing guide: see Social Media Scraping Overview. Endpoints with a channel request field let you choose apify, rapid, or memories.ai; endpoints without this field use managed routing.
Pricing:
  • rapid channel: $0.01 per video
  • memories.ai channel: $0.01 per video
  • apify channel: Charged at Apify’s actual cost (higher and variable pricing)

​
Code Example

import requests

BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-mavi-..."
HEADERS = {
    "Authorization": f"{API_KEY}"
}

def instagram_video_metadata(video_url: str, channel: str):
    url = f"{BASE_URL}/instagram/video/metadata"
    data = {"video_url": video_url, "channel": channel}
    resp = requests.post(url, headers=HEADERS, json=data)
    return resp.json()

# Usage example
result = instagram_video_metadata("https://www.instagram.com/reels/DLlGZiCOBQ0/", "apify")
print(result)

​
Request Body

FieldTypeRequiredDescription
video_urlstringYesThe Instagram video URL. Must be a Reel URL (/reels/<shortcode>/ or /reel/<shortcode>/). Post URLs (/p/<shortcode>/) are rejected with HTTP 400 "instagram url error" — even when the post is a video.
channelstringYesThe channel name. Supported values: apify, rapid, memories.ai

​
Response

Response shape depends on the channel parameter — same channel-dependent split as the YouTube and TikTok siblings. Verified live:
  • channel: "apify" — data is an array of flat metadata objects with {inputUrl, id, type, shortCode, caption, hashtags, ...}. May return {url, error: "restricted_page", errorDescription} for posts behind login walls.
  • channel: "memories.ai" — data is an object wrapping Instagram’s internal GraphQL shape: {data: {xdt_shortcode_media: {...}}, extensions, status}.
  • channel: "rapid" — same alternative shape as memories.ai.
The example below is the memories.ai GraphQL shape, not the apify shape the code example requests. Pick a channel per integration and expect to write a small adapter when switching.
{
  "code": 200,
  "msg": "success",
  "data": {
    "data": {
      "xdt_shortcode_media": {
        "__typename": "XDTGraphVideo",
        "id": "3667365614373573684",
        "shortcode": "DLlGZiCOBQ0",
        "thumbnail_src": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-15/...",
        "dimensions": {
          "height": 1136,
          "width": 640
        },
        "display_url": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-15/...",
        "display_resources": [
          {
            "src": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-15/...",
            "config_width": 640,
            "config_height": 1136
          }
        ],
        "dash_info": {
          "is_dash_eligible": true,
          "video_dash_manifest": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>...",
          "number_of_qualities": 1
        },
        "has_audio": true,
        "video_url": "https://scontent-jnb2-1.cdninstagram.com/o1/v/t2/f2/m86/...",
        "video_view_count": 27040,
        "video_play_count": 1799817,
        "product_type": "clips",
        "video_duration": 41.125,
        "clips_music_attribution_info": {
          "artist_name": "humansofny",
          "song_name": "Original audio",
          "uses_original_audio": true,
          "audio_id": "24313369781619226"
        },
        "is_video": true,
        "owner": {
          "id": "242598499",
          "username": "humansofny",
          "is_verified": true,
          "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/v/t51.2885-19/...",
          "full_name": "Humans of New York",
          "edge_followed_by": {
            "count": 12804266
          }
        },
        "edge_media_to_caption": {
          "edges": [
            {
              "node": {
                "text": "I have the moves that they're looking for.",
                "created_at": "1751404145"
              }
            }
          ]
        },
        "edge_media_to_parent_comment": {
          "count": 487,
          "edges": [
            {
              "node": {
                "id": "18094151056886709",
                "text": "Go for it sweetie!!!",
                "created_at": 1762011704,
                "owner": {
                  "username": "iam_carrongrazette"
                }
              }
            }
          ]
        },
        "edge_media_preview_like": {
          "count": 27791
        },
        "taken_at_timestamp": 1751404144
      }
    },
    "extensions": {
      "is_final": true
    },
    "status": "ok"
  },
  "failed": false,
  "success": true
}

​
Response Parameters

ParameterTypeDescription
codestringResponse code indicating the result status
msgstringResponse message describing the operation result
dataobjectResponse data object containing Instagram metadata
data.dataobjectInstagram data object
data.data.xdt_shortcode_mediaobjectInstagram video media object
data.data.xdt_shortcode_media.idstringVideo ID
data.data.xdt_shortcode_media.shortcodestringInstagram short code
data.data.xdt_shortcode_media.thumbnail_srcstringThumbnail image URL
data.data.xdt_shortcode_media.dimensionsobjectVideo dimensions (height, width)
data.data.xdt_shortcode_media.display_urlstringDisplay image URL
data.data.xdt_shortcode_media.video_urlstringDirect video URL
data.data.xdt_shortcode_media.video_view_countnumberNumber of video views
data.data.xdt_shortcode_media.video_play_countnumberNumber of video plays
data.data.xdt_shortcode_media.video_durationnumberVideo duration in seconds
data.data.xdt_shortcode_media.product_typestringProduct type (e.g., “clips”)
data.data.xdt_shortcode_media.ownerobjectVideo owner information
data.data.xdt_shortcode_media.owner.usernamestringOwner username
data.data.xdt_shortcode_media.owner.full_namestringOwner full name
data.data.xdt_shortcode_media.edge_media_to_captionobjectVideo caption information
data.data.xdt_shortcode_media.edge_media_to_parent_commentobjectComments information
data.data.xdt_shortcode_media.edge_media_preview_likeobjectLikes information
data.statusstringResponse status
successbooleanIndicates whether the operation was successful
failedbooleanIndicates whether the operation failed

Authorizations

​
Authorization
string
header
required

Body

application/json
​
video_url
string
required

The Instagram video URL

Example:

"https://www.instagram.com/reels/DLlGZiCOBQ0/"

​
channel
enum<string>
required

The channel name. Supported values: apify, rapid, memories.ai

Available options:
apify,
rapid,
memories.ai
Example:

"apify"

Response

200 - application/json

Video metadata information with detailed Instagram data

​
code
string

Response code indicating the result status

Example:

200

​
msg
string

Response message describing the operation result

Example:

"success"

​
data
object

Response data object containing Instagram metadata

​
success
boolean

Indicates whether the operation was successful

Example:

true

​
failed
boolean

Indicates whether the operation failed

Example:

false