Skip to main content
POST
Instagram Location Posts API

Instagram Location Posts

Collect public posts tagged at an Instagram location, either the top posts or the newest ones, with captions, authors, like and comment counts and media. Submit an asynchronous task, then read its standard results.
Identify the location with either location_id or its location page url. Set sort_by to top (default) for the location’s top posts or recent for the newest posts; results_limit sets how many posts to return (default 20, up to 100).

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

Identify the location with either location_id or its location page url. Set sort_by to top (default) for the location's top posts or recent for the newest posts; results_limit sets how many posts to return (default 20, up to 100).

location_id
string
required

Numeric Instagram location ID, as returned by Instagram Location Search.

Pattern: ^[0-9]{1,32}$
callback_url
string<uri>
results_limit
integer
default:20
Required range: 1 <= x <= 100
sort_by
enum<string>
default:top
Available options:
recent,
top
Minimum string length: 1
url
string

Instagram location page URL, such as https://www.instagram.com/explore/locations/212988663/.

Minimum string length: 1

Response

Task accepted

code
integer
data
object