Instagram Location Authors

Overview

List the accounts actively posting from a place — authors of the top posts (sort: top, the default) or of the newest posts (sort: recent) — as one page of short profiles per call. Give the place by its numeric location_id, or by place as a free-text name that resolves to the first matching location. Repeat next_cursor back as cursor for the next page; null means the end of the list.

Fetched pages are cached for 24 hours and shared across the platform — a second request for the same page within that window answers instantly and is charged the lower cached price.

When to use

Source leads from a territory: the accounts posting from a city or venue are the businesses and creators active there.
Combine with a keyword: run the places of a region and filter the authors through instagram_profile.

[!NOTE] A place name that matches no location completes successfully with found: false and is not charged — the media list is never fetched then. Genuine errors of the data service (auth, rate limit, 5xx) still fail the run and are refunded.

The list carries no email addresses or phone numbers. Call instagram_profile with a returned username for bio, website and public contact fields.

Endpoint

Input

Output

Paging

Each call returns one page. To get the next page, pass the value of next_cursor back as cursor. A null cursor means the list is fully read. Pages are priced individually, so page only as deep as you need.

Pricing

This enrichment costs 2 credits for a freshly fetched page. A page served from the cache (at most 24 hours old) is charged the lower cached tier. Pages without accounts and runs ending with found: false are free.

Examples

Playground

States

State	Description
`queued`	Request accepted; waiting to be picked up by a worker.
`processing`	Worker is actively running the enrichment.
`completed`	Enrichment finished and results are available in `output`.
`failed`	Enrichment failed; reason is in `error`. Credits are refunded for failures unless otherwise noted.

Errors

Error	When it happens	What to do
`invalid_input`	Neither `location_id` nor `place` is given, `location_id` is not numeric, `place` is shorter than 2 characters, `sort` is not `top` or `recent`, or `cursor` is malformed.	Pass a numeric location id or a place name like `Berlin`.
`not_found`	The place search matched no location.	Try a different name or pass a known `location_id` — the run costs nothing.
`rate_limited`	The data service throttled the request.	Retry with backoff.
`provider_error`	The data service returned an unexpected error.	Retry; if persistent, contact support.
`503 endpoint_unavailable`	The endpoint is currently not configured or temporarily disabled. Nothing is reserved or charged.	Retry later; if persistent, contact support.