POST

/api/ig/download

Create a new Instagram video download task. Supports Posts, Reels, Stories, and Share links.

Cost: 5 requests

Supported Instagram Formats

Posts

/p/[post_id]

Reels

/reel/[reel_id]

Stories

/stories/[story_id]

Share Links

/share/[share_id]

Request Parameters

Parameter	Type	Description
instagram_url	string	Valid Instagram URL (posts, reels, stories, share links)

Request Example

curl -X POST \
  https://socket-app-jb.store/api/ig/download \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your_api_key' \
  -d '{
    "instagram_url": "https://www.instagram.com/reel/DKea1rTtgzB/"
  }'

Response Example

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "instagram_url": "https://www.instagram.com/reel/DKea1rTtgzB/",
  "created_at": "2025-06-06T12:00:00Z",
  "message": "Download task created successfully. Video will be processed in background."
}

GET

/api/ig/download/{task_id}/status

Check the status of your Instagram download task.

FREE - No requests charged

Status Values

pending

Task is queued for processing

processing

Video is being downloaded

completed

Video is ready for download

failed

Download failed (check error_message)

Request Example

curl -X GET \
  https://socket-app-jb.store/api/ig/download/550e8400-e29b-41d4-a716-446655440000/status \
  -H 'X-API-Key: your_api_key'

Response Example

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "instagram_url": "https://www.instagram.com/reel/DKea1rTtgzB/",
  "created_at": "2025-06-06T12:00:00Z",
  "started_at": "2025-06-06T12:00:05Z",
  "completed_at": "2025-06-06T12:01:30Z",
  "expires_at": "2025-06-07T12:01:30Z",
  "downloaded": false,
  "error_message": null
}

POST

/api/v2/profile

Create a task to retrieve Instagram profile information. Returns a task ID for status tracking.

Cost: 1 request

Request Parameters

Parameter	Type	Description
user_link	string	Instagram profile URL (e.g., https://instagram.com/username/)

Request Example

curl -X POST \
  https://socket-app-jb.store/api/v2/profile \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your_api_key' \
  -d '{
    "user_link": "https://www.instagram.com/instagram/"
  }'

Response Example

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Task queued successfully"
}

POST

/api/v2/reels

Create a task to retrieve Instagram user reels with pagination support. Returns a task ID for status tracking.

✨ UPDATED: Now uses get_user_media for eliminating duplicate reels and getting current view/like counts that match Instagram.

⚠️ IMPORTANT: May return fewer reels than requested if there are other posts (photos, carousels) between reels in the user's media feed.

Cost: 1 request

Request Parameters

Parameter	Type	Description	Required
instagram_id	string	Instagram user ID (numeric string)	Yes
count	integer	Number of reels to fetch (maximum: 12, default: 12)	No
max_id	string	Pagination cursor from previous response (optional)	No

Request Example

curl -X POST \
  https://socket-app-jb.store/api/v2/reels \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your_api_key' \
  -d '{
    "instagram_id": "25025320",
    "count": 5
  }'

Response Example

{
  "task_id": "550e8400-e29b-41d4-a716-446655440001",
  "status": "pending",
  "message": "Task queued successfully"
}

GET

/api/v2/task/{task_id}

Retrieve the status and results of a previously created task.

FREE - No requests charged

Request Example

curl -X GET \
  https://socket-app-jb.store/api/v2/task/550e8400-e29b-41d4-a716-446655440000 \
  -H 'X-API-Key: your_api_key'

Response Example (Completed Profile Task)

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:31:30Z",
  "result": {
    "username": "instagram",
    "full_name": "Instagram",
    "follower_count": 618000000,
    "following_count": 76,
    "media_count": 7462,
    "is_private": false,
    "biography": "Bringing you closer to the people and things you love. ❤️",
    "profile_pic_url": "https://scontent-ort2-1.cdninstagram.com/v/...",
    "user_id": "25025320"
  }
}

GET

/api/v2/account

Get information about your API account, including usage statistics and limits.

FREE - No requests charged

Request Example

curl -X GET \
  https://socket-app-jb.store/api/v2/account \
  -H 'X-API-Key: your_api_key'

Response Example

{
  "username": "your_username",
  "email": "your_email@example.com",
  "subscription_tier": "pro",
  "requests_used": 1250,
  "requests_limit": 300000,
  "subscription_expires": "2024-02-15T00:00:00Z",
  "created_at": "2024-01-01T00:00:00Z"
}

API Documentation v2

Introduction

API v2 Queue System

Base URL

Authentication

Want to get started?

API Endpoints

Instagram Data Extraction

Instagram Video Downloads NEW

Task Management

/api/ig/download

Supported Instagram Formats

Posts

Reels

Stories

Share Links

Request Parameters

Request Example

Response Example

/api/ig/download/{task_id}/status

Status Values

Request Example

Response Example

/api/v2/profile

Request Parameters

Request Example

Response Example

/api/v2/reels

Request Parameters

Request Example

Response Example

/api/v2/task/{task_id}

Request Example

Response Example (Completed Profile Task)

/api/v2/account

Request Example

Response Example

Error Codes & Best Practices

Common Error Codes

Best Practices