Skip to main content
POST
Instagram Posts API

Instagram Posts

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

Endpoint

Request Body

Provide either usernames or public Instagram profile urls. The legacy query field does not select posts and cannot be used on its own; use Instagram Search for keyword searches.

Validation

A request containing only the legacy query field is rejected before task creation and is not billed:
Existing integrations may continue sending query together with valid usernames or urls; the request remains compatible, but query is ignored.

Use with MCP

Use the JSON request body above as the nested input object for socq_execute, or pass the same fields directly to the typed tool. Typed tools also accept _wait_seconds, _result_limit, and _idempotency_key.
A successful collection returns a task_id. Continue with socq_get_task until the task succeeds, then read normalized records from results.items.
See MCP quickstart for the complete submission and polling flow.

Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.

Completed Task Response

You can pass multiple public usernames in the same field:

Authorizations

Authorization
string
header
required

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

Body

application/json
urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>
query
string
deprecated

Deprecated for Instagram Posts and does not select posts. Use usernames or profile URLs, or call Instagram Search.

Minimum string length: 1
results_limit
integer
Required range: 1 <= x <= 2000
usernames
string[]

Public account usernames.

Minimum array length: 1
Minimum string length: 1

Response

Task accepted

code
integer
data
object