Skip to main content
POST
/
v1
/
instagram
/
posts
curl --request POST \ --url https://api.socq.ai/v1/instagram/posts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "results_limit": 10, "usernames": [ "instagram" ] } '
{
  "code": 200,
  "data": {
    "task_id": "A1B2C3D4E5F6G7H8",
    "status": "queued",
    "created_time": "2023-11-07T05:31:56Z"
  }
}
{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}
{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}
{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

​
Instagram Posts

Collect public Instagram post data, including caption text, engagement metrics, media URLs, author fields, and raw JSONL output.

​
Endpoint

POST https://api.socq.ai/v1/instagram/posts

​
Request Body

{
  "usernames": ["instagram"],
  "results_limit": 10
}

​
Result Item

After the task succeeds, call GET /v1/tasks/{task_id} to read paginated standard records under results. 
{
  "id": "3936101605334124689",
  "platform": "instagram",
  "resource": "posts",
  "type": "post",
  "shortcode": "Daf145ByQiR",
  "url": "https://www.instagram.com/p/Daf145ByQiR/",
  "caption": "Post caption text",
  "author": {
    "id": "25025320",
    "username": "instagram",
    "name": "Instagram",
    "url": "https://www.instagram.com/instagram",
    "avatar_url": null,
    "is_verified": null,
    "is_private": null
  },
  "metrics": {
    "likes_count": 109798,
    "comments_count": 4731,
    "views_count": 5780995,
    "plays_count": 40309867
  },
  "media": [
    {
      "type": "video",
      "url": "https://example.com/video.mp4",
      "thumbnail_url": "https://example.com/thumbnail.jpg",
      "width": 1080,
      "height": 1920,
      "duration_seconds": 29.9
    }
  ],
  "hashtags": [],
  "mentions": ["creator"],
  "created_at": "2026-07-07T16:00:36",
  "collected_at": "2026-07-08T08:59:45",
  "extra": {}
}
You can pass multiple public usernames in the same field: 
{
  "usernames": [
    "instagram",
    "creators"
  ],
  "results_limit": 10
}

​
Response

{
  "code": 200,
  "data": {
    "task_id": "A1B2C3D4E5F6G7H8",
    "status": "queued",
    "created_time": "2026-07-08T10:30:00"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
urls
string[]

Array of public URLs to collect.

​
usernames
string[]

Array of public usernames to collect.

​
query
string

Search query

​
results_limit
integer

Maximum number of results to collect

Required range: x >= 1
​
callback_url
string

Optional callback URL

Response

Task submitted

​
code
integer
Example:

200

​
data
object