Instagram Downloader API Documentation

Instagram Profile

Fetch a User Profile (Process Profile)

Fetches (processes) the profile of a Instagram user, using the Instagram profile URL.

The response of this request will provide profile information.

⏱️ Processing Time: Profile fetching can take anywhere from a few seconds to several minutes depending on the profile size and Instagram’s response time. If you receive a pending status, poll the endpoint at reasonable intervals (every 10-30 seconds) until processing is complete.

Endpoint

POST https://dashboard.transcriptdownloader.com/api/instagram/profile

Body

{
     "url": "<string>"
}

Example responses

Successful response - when profile data is cached/ready

{
  "status": "success",
  "account": "username",
  "fbid": "12345678901234567",
  "instagram_id": "12345678",
  "profile_name": "Display Name",
  "full_name": "Full Name",
  "biography": "Profile biography text",
  "profile_image_link": "https://scontent.cdninstagram.com/...",
  "followers": 1500000,
  "following": 500,
  "posts_count": 1250,
  "is_verified": true,
  "is_private": false,
  "is_business_account": true,
  "is_professional_account": true,
  "avg_engagement": 5.2,
  "category_name": "Business Category",
  "highlights_count": 5,
  "is_joined_recently": false,
  "has_channel": false,
  "business_address": "123 Main St",
  "email": "contact@example.com",
  "external_url": "https://website.com",
  "profile_url": "https://www.instagram.com/username/",
  "url": "https://www.instagram.com/username/",
  "bio_hashtags": ["#hashtag1", "#hashtag2"],
  "highlights": ["highlight1", "highlight2"],
  "related_accounts": [
    {
      "instagram_id": "87654321",
      "user_name": "related_user",
      "profile_name": "Related User",
      "is_private": false,
      "is_verified": true
    }
  ],
  "list_id": "01KB21QX05P6B4JA7FJHTM7AWE",
  "list_cost": 0.50,
  "download": {
    "id": "01KB21QX05P6B4JA7FJHTM7AWE",
    "media_id": "72913730006",
    "type": "instagram_profile",
    "cost": "0.100",
    "status": "success",
    "created_at": "2025-11-27T06:59:31.000000Z"
  }
}

Pending download - when profile fetch is initiated

{
  "status": "pending",
  "message": "Profile downloading initiated.",
  "download_id": "01KB21QX05P6B4JA7FJHTM7AWE",
  "list_id": "01KB21QX05P6B4JA7FJHTM7AWE",
  "list_cost": 0.50,
  "source": "api",
  "cost": "0.100",
  "download": {
    "id": "01KB21QX05P6B4JA7FJHTM7AWE",
    "type": "instagram_profile",
    "status": "pending"
  },
  "last_response": {
    "download_id": "01KB20ABC123456789",
    "status": "failed",
    "response": "Unable to process. Required metadata for this URL is unavailable.",
    "created_at": "2025-11-27T06:45:00.000000Z"
  }
}

📋 Note: The last_response object is only included when there was a failed download for the same profile within the last 30 minutes. This helps identify recurring issues with specific profiles.

Error responses

Download Posts List

Get All Posts & Reels List of the Profile

Our API retrieves an Instagram profile’s complete posts and reels with partial metadata.

⏱️ Processing Time: Downloading a complete list of posts and reels can take 3-10 minutes depending on the profile size. Poll the endpoint at reasonable intervals (every 10-30 seconds) until processing is complete.

Endpoint

POST https://dashboard.transcriptdownloader.com/api/instagram/list

📋 Note: Call the Profile endpoint first to retrieve the list_id. The retrieved list_id is valid for 1 hour.

Body

{
    "list_id": "<string>"
}

Example Response

Successful response - when list data is ready

{
  "status": "success",
  "message": "List downloading completed successfully.",
  "posts": [
    {
      "type": "post",
      "instagram_id": "post_12345",
      "caption": "Post caption text",
      "description": null,
      "likes": 5000,
      "comments": 250,
      "num_comments": 250,
      "date_posted": "2025-09-10T15:30:00Z",
      "user_posted": "username",
      "account": "username",
      "image_url": "https://scontent.cdninstagram.com/...",
      "video_url": null,
      "url": "https://www.instagram.com/p/ABC123/",
      "shortcode": "ABC123",
      "content_type": "image",
      "photos_number": 1,
      "videos_duration": null,
      "location": {"name": "Location Name"},
      "post_id": "post_12345",
      "datetime": "2025-09-10T15:30:00Z",
      "photos": ["https://image1.jpg"],
      "videos": [],
      "images": ["https://image1.jpg"],
      "audio": []
    }
  ],
  "reels": [
    {
      "type": "reel",
      "post_id": "reel_12345",
      "description": "Reel description",
      "likes": 25000,
      "views": 500000,
      "video_view_count": 500000,
      "video_play_count": 480000,
      "num_comments": 1200,
      "date_posted": "2025-09-09T12:00:00Z",
      "user_posted": "username",
      "account": "username",
      "video_url": "https://scontent.cdninstagram.com/reel.mp4",
      "thumbnail": "https://thumbnail.jpg",
      "url": "https://www.instagram.com/reel/XYZ789/",
      "shortcode": "XYZ789",
      "content_type": "reel",
      "content_id": "reel_content_123",
      "product_type": "reel",
      "length": 30,
      "videos_duration": 30,
      "is_verified": true,
      "videos": ["https://scontent.cdninstagram.com/reel.mp4"]
    }
  ],
  "posts_count": 262,
  "reels_count": 155,
  "total_count": 417,
  "downloads": {
    "posts": {
      "id": "01KB21AQQ0N2FMV840TFX8R6FS",
      "type": "instagram_list_posts",
      "status": "success",
      "cost": "0.250"
    },
    "reels": {
      "id": "01KB21AQQ1BTDFAZY75TNPMDT3",
      "type": "instagram_list_reels",
      "status": "success",
      "cost": "0.250"
    }
  }
}

Pending List Download - when list fetch is initiated

{
  "status": "pending",
  "message": "List downloading initiated.",
  "downloads": {
    "posts": {
      "id": "01KB21AQQ0N2FMV840TFX8R6FS",
      "type": "instagram_list_posts",
      "status": "pending"
    },
    "reels": {
      "id": "01KB21AQQ1BTDFAZY75TNPMDT3",
      "type": "instagram_list_reels",
      "status": "pending"
    }
  },
  "total_cost": 0.50,
  "last_response": {
    "posts": {
      "download_id": "01KB20ABC123456789",
      "status": "failed",
      "response": "Unable to process. Required metadata for this URL is unavailable.",
      "created_at": "2025-11-27T06:45:00.000000Z"
    },
    "reels": {
      "download_id": "01KB20DEF987654321",
      "status": "failed",
      "response": "Unable to process. Required metadata for this URL is unavailable.",
      "created_at": "2025-11-27T06:45:00.000000Z"
    }
  }
}

📋 Note: The last_response object is only included when there was a failed download for posts or reels within the last 30 minutes. It can contain posts, reels, or both depending on which failed.

Error responses

Fetch Content Metadata using the URL

Our API allows you to retrieve comprehensive metadata for any Instagram post or reel by simply providing its URL.

⏱️ Processing Time: Content metadata fetching can take anywhere from a few seconds to several minutes. Poll the endpoint at reasonable intervals (every 10-30 seconds) until processing is complete.

Endpoint

POST https://dashboard.transcriptdownloader.com/api/instagram/content

Body

{
    "url": "<string>"
}

Note: The download_id parameter is no longer required. If the profile doesn’t exist, it will be automatically fetched and the cost will include both content and profile prices.

Example response (Post) - Successful

{
  "type": "post",
  "instagram_id": "post_12345",
  "caption": "Amazing sunset today! #nature #photography",
  "description": null,
  "hashtags": ["#nature", "#photography"],
  "likes": 5000,
  "comments": 250,
  "num_comments": 250,
  "date_posted": "2025-09-10T15:30:00Z",
  "user_posted": "photographer_user",
  "account": "photographer_user",
  "image_url": "https://scontent.cdninstagram.com/image.jpg",
  "video_url": null,
  "url": "https://www.instagram.com/p/ABC123/",
  "shortcode": "ABC123",
  "content_type": "image",
  "pk": "post_pk_12345",
  "content_id": "content_12345",
  "thumbnail": "https://thumbnail.jpg",
  "is_verified": true,
  "is_paid_partnership": false,
  "user_posted_id": "12345678",
  "profile_url": "https://www.instagram.com/photographer_user/",
  "alt_text": "Beautiful sunset over mountains",
  "photos_number": 1,
  "videos_duration": null,
  "location": {"name": "Mountain View, CA"},
  "post_id": "post_12345",
  "followers": 150000,
  "posts_count": 500,
  "profile_image_link": "https://profile.jpg",
  "datetime": "2025-09-10T15:30:00Z",
  "timestamp": "2025-09-10T15:30:00Z",
  "video_view_count": 0,
  "product_type": "feed",
  "video_play_count": 0,
  "is_pinned": false,
  "photos": ["https://image1.jpg", "https://image2.jpg"],
  "videos": [],
  "images": ["https://image1.jpg", "https://image2.jpg"],
  "latest_comments": [
    {
      "comment": "Beautiful shot!",
      "user_commenting": "commenter1",
      "likes": 15,
      "created_at": "2025-09-10T16:00:00Z"
    }
  ],
  "tagged_users": [
    {
      "username": "tagged_user",
      "full_name": "Tagged User Name",
      "is_verified": false
    }
  ],
  "audio": [],
  "coauthor_producers": [],
  "partnership_details": [],
  "post_content": [
    {
      "index": 0,
      "type": "image",
      "url": "https://content1.jpg",
      "instagram_id": "content_id_123"
    }
  ],
  "status": "success",
  "source": "api"
}

Example response (Reel) - Successful

{
  "type": "reel",
  "post_id": "reel_12345",
  "description": "Check out this amazing dance! #dance #viral",
  "hashtags": ["#dance", "#viral"],
  "likes": 25000,
  "views": 500000,
  "video_view_count": 500000,
  "video_play_count": 480000,
  "num_comments": 1200,
  "date_posted": "2025-09-09T12:00:00Z",
  "user_posted": "dancer_user",
  "account": "dancer_user",
  "video_url": "https://scontent.cdninstagram.com/reel.mp4",
  "thumbnail": "https://reel_thumbnail.jpg",
  "url": "https://www.instagram.com/reel/XYZ789/",
  "shortcode": "XYZ789",
  "content_type": "reel",
  "content_id": "reel_content_123",
  "product_type": "reel",
  "length": 30,
  "videos_duration": 30,
  "is_verified": true,
  "is_paid_partnership": false,
  "followers": 2500000,
  "posts_count": 800,
  "videos": ["https://scontent.cdninstagram.com/reel.mp4"],
  "latest_comments": [
    {
      "comment": "Amazing moves!",
      "user_commenting": "fan_user",
      "likes": 50,
      "date_of_comment": "2025-09-09T13:00:00Z"
    }
  ],
  "tagged_users": [],
  "coauthor_producers": [],
  "status": "success",
  "source": "api"
}

Pending response

{
  "status": "pending",
  "message": "Post downloading initiated.",
  "download_id": "01HXYZ987654321",
  "cost": "0.025",
  "download": {
    "id": "01HXYZ987654321",
    "type": "instagram_post",
    "status": "pending"
  },
  "last_response": {
    "download_id": "01HXYZ123456789",
    "status": "failed",
    "response": "Unable to process. Required metadata for this URL is unavailable.",
    "created_at": "2025-11-27T06:45:00.000000Z"
  }
}

📋 Note: The last_response object is only included when there was a failed download for the same content within the last 30 minutes. This helps identify recurring issues with specific posts or reels.

Error responses

Instagram Audio

Initialize Instagram Audio Download (Process Audio)

Initializes (processes) the audio download of an Instagram reel or video post, using the content URL.

⏱️ Processing Time: Audio extraction can take anywhere from a few seconds to several minutes depending on the video duration. Poll the download endpoint at reasonable intervals (every 10-30 seconds) until the status changes to success.

Endpoint

POST https://dashboard.transcriptdownloader.com/api/instagram/audio

Body

{
    "url": "<string>"
}

The URL must be a valid Instagram post (/p/) or reel (/reel/) URL.

Example responses

Successful response

{
    "data": {
        "id": "01KB21QX05P6B4JA7FJHTM7AWE",
        "media_id": "ABC123xyz",
        "type": "instagram_audio",
        "duration": "00:00:30",
        "cost": "0.050",
        "status": "pending",
        "audio_url": null
    }
}

Completed download

{
    "data": {
        "id": "01KB21QX05P6B4JA7FJHTM7AWE",
        "type": "instagram_audio",
        "status": "success",
        "audio_url": "https://drive.transcriptdownloader.com/audios/instagram-ABC123xyz.mp3?Expires=..."
    }
}

No audio content (image-only post)

{
    "status": "success",
    "message": "This content does not contain audio.",
    "download_id": "01KB21QX05P6B4JA7FJHTM7AWE",
    "cost": "0.025"
}

Error responses

Endpoint

GET https://dashboard.transcriptdownloader.com/downloads/{downloadId}

Example responses

Success - Audio ready

{
    "data": {
        "id": "01KB21QX05P6B4JA7FJHTM7AWE",
        "type": "instagram_audio",
        "status": "success",
        "audio_url": "https://drive.transcriptdownloader.com/audios/instagram-ABC123xyz.mp3?Expires=..."
    }
}

Pending - Still processing

{
    "data": {
        "id": "01KB21QX05P6B4JA7FJHTM7AWE",
        "type": "instagram_audio",
        "status": "pending",
        "audio_url": null
    }
}

Support

If you need assistance or have any questions about using the API, please contact our support team at https://transcriptdownloader.com/#contact.