Instagram Locations in a city API

List the places in a city of the Instagram places directory, from a city_id (c plus digits): location_id, name, slug and url, for $0.56 per 1,000 calls.

  • location_id feeds location_info
  • A city page link works as input
  • Failed calls and empty results are not charged

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "city_locations",
      "params": {
        "city_id": "c2728325"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "rank": 1,
          "location_id": "3000346",
          "name": "St. Patrick's Cathedral",
          "slug": "st-patricks-cathedral"
        },
        …
      ],
      "count": 96
    }
  3. 3Rows

    ranklocation_idnameslug
    13000346St. Patrick's Cathedralst-patricks-cathedral
    21176464239075912New York City - Manhattan - Nycnew-york-city-manhattan-nyc
  4. 4CSV

    instagram-city_locations-sample.csv rank,location_id,name,slug,url,city_id,city_name,country_code,country_name,platform

A request with city_id goes in. One response returns a page of that city's places from the places directory, each row with location_id, name and slug. These become table rows and a CSV file.

What data you get

The table shows rows from a real call for city c2728325, captured November 21, 2026 at 07:18 (UTC), that returned 96 rows. Your own calls return these fields as listed in the field reference.

ranklocation_idnameslugurlcity_idcity_namecountry_codecountry_nameplatform
13000346St. Patrick's Cathedralst-patricks-cathedralhttps://www.instagram.com/explore/locations/3000346/st-patricks-cathedral/c2728325MidtownEastUSUnited Statesinstagram
21176464239075912New York City - Manhattan - Nycnew-york-city-manhattan-nychttps://www.instagram.com/explore/locations/1176464239075912/new-york-city-manhattan-nyc/c2728325MidtownEastUSUnited Statesinstagram

Use cases

  • List the places in a city

    Give one city_id and read the places under that city in the places directory.

  • Go on to place details

    Pass location_id to location_info to read the coordinates and category.

  • Go on to the posts at a place

    Pass location_id to location_posts to see the posts at that place.

  • Build a place list for a city

    Store name, slug and url and match them to the pages in the places directory.

Instagram Graph API vs EveryInfra

Here is how the official Instagram Graph API and EveryInfra city_locations compare on account requirement and on access review.

ComparedInstagram Graph APIEveryInfra
Account requirement"To use the APIs, your app users must have an Instagram professional account"The request carries city_id and one EveryInfra API key. You and your users do not need an Instagram professional account.
Access review"Advanced Access is the access level required if your app serves Instagram professional accounts that you don’t own or manage" and "This access level requires App Review and Business Verification."You send one EveryInfra API key in the Authorization: Bearer header. You do not submit a Meta app review and do not log in to Instagram.

Quotes are from Meta's developer documentation, checked 2026-11-22. This table compares access conditions only. Official sources: Instagram Platform overview (updated 2026-10-29)

Limits and gotchas

  • city_id is required: c plus digits, such as c2728325, taken from the city_id of location_cities. A city page link also works.
  • The result is the places under that city in the Instagram places directory. A city that is not in the directory returns an empty result and is not charged.
  • One call returns one page. If the response has next_page_token, send it back unchanged as page_token and keep the other parameters the same. The token is valid for 24 hours, and each page counts as one call. With no next_page_token, you cannot page further.
  • The last page can be short.
  • city_name is the name of the city in the places directory and is the same on every row.
  • This capability only lists places. For coordinates and category, use location_info.

Pricing

You pay $0.000556 per call, not per row. Each page counts as one call. Failed calls and empty results are not charged.

CallsCost
10,000$5.56
100,000$55.56
1,000,000$555.56

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "city_locations",
  "params": {
    "city_id": "c2728325"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for city_locations, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Instagram Locations in a city endpoint (instagram/city_locations).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to instagram and action to city_locations, and put the parameters inside params.
- Required parameters:
  - city_id: A city ID from location_cities (c followed by digits, such as c2728325), or a city page link.
- Optional parameters:
  - page_token: Page token for city_locations. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged.
- Returns a list of records. Main fields of each record: rank (Position from 1: the order of this row…), location_id (Location ID), name, slug (The name part of the Instagram location…), url, city_id (City ID, c followed by digits, such as…), city_name ((city_locations) The city's name in Ins…), country_code (Two-letter country code (ISO 3166-1), s…), country_name (Country name in English, such as United…).
- Example request body:
{
  "platform": "instagram",
  "action": "city_locations",
  "params": {
    "city_id": "c2728325"
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesinstagramPlatform identifier, fixed value.
actionbodystringYescity_locationsCapability identifier, fixed value.
city_idbody.paramsstringYes-A city ID from location_cities (c followed by digits, such as c2728325), or a city page link.
page_tokenbody.paramsstringNo-Page token for city_locations. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours and each page is one call; the last page has no next_page_token.

Response example

#
Captured November 21, 2026 at 07:18 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "instagram",  "action": "city_locations",  "results": [    {      "rank": 1,      "location_id": "3000346",      "name": "St. Patrick's Cathedral",      "slug": "st-patricks-cathedral",      "url": "https://www.instagram.com/explore/locations/3000346/st-patricks-cathedral/",      "city_id": "c2728325",      "city_name": "MidtownEast",      "country_code": "US",      "country_name": "United States",      "platform": "instagram"    },    {      "rank": 2,      "location_id": "1176464239075912",      "name": "New York City - Manhattan - Nyc",      "slug": "new-york-city-manhattan-nyc",      "url": "https://www.instagram.com/explore/locations/1176464239075912/new-york-city-manhattan-nyc/",      "city_id": "c2728325",      "city_name": "MidtownEast",      "country_code": "US",      "country_name": "United States",      "platform": "instagram"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 96,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
rankPosition from 1: the order of this row within this result. user_search: first the accounts returned by Instagram's search box (matched_by is search_box), in the search box's order; then the authors of posts found with this keyword, added to fill up the count (matched_by is post_author); results without matched_by carry the position at which Instagram ranks the account for this keyword. similar_profiles: the account's place among the similar accounts, ordered by followers. likers: the account's place in the list of likers.
location_idLocation ID. Pass it to location_info, location_nearby or location_posts.
nameName of the object itself, for account, product and business capabilities.
slugThe name part of the Instagram location directory link, such as st-patricks-cathedral.
urlLink to the record on the platform.
city_idCity ID, c followed by digits, such as c2728325. Pass it to city_locations.
city_name(city_locations) The city's name in Instagram's location directory, the same on every row.
country_codeTwo-letter country code (ISO 3166-1), such as US.
country_nameCountry name in English, such as United States.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Instagram places-in-a-city API return?

Each row is one place: location_id, name, slug and url, plus city_id, city_name, country_code, country_name and rank.

Where do I get city_id?

Use the city_id (c plus digits) in the results of location_cities. You can also pass a city page link.

How do I get the next page?

When the response has next_page_token, send it back unchanged as page_token and keep the other parameters the same. With no next_page_token, you cannot page further.

How much does one page cost?

It costs $0.000556 per call, or $0.56 per 1,000 calls. Each page counts as one call, not each row. Failed calls and empty results are not charged.

Do I need an Instagram login?

No. You send one EveryInfra API key in the Authorization: Bearer header, and the request carries only city_id. No Instagram login or access token is needed.

You can call the other Instagram endpoints with the same key, such as location_posts to read the posts at one place.

Google Analytics needs consent. Privacy