Skip to main content
POST
Instagram Stories API

Instagram Stories

Collect the stories a public Instagram account currently has live, with media URLs, the author and posting times. Submit an asynchronous task, then read its standard results.
Provide a public Instagram username. Returns the stories the account currently has live; each story stays available for 24 hours after posting.

Standard 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. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

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

Body

application/json

Provide a public Instagram username. Returns the stories the account currently has live; each story stays available for 24 hours after posting.

username
string
required

Public Instagram username, with an optional leading @.

Minimum string length: 1
Pattern: ^@?[A-Za-z0-9._]{1,30}$
callback_url
string<uri>

Response

Task accepted

code
integer
data
object