Instagram Cities in a country API

List the cities of a country in the Instagram places directory, from a two-letter country_code such as US: city_id, name, slug and url, for $0.56 per 1,000 calls.

  • city_id feeds city_locations
  • Upper or lower case both work
  • 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": "location_cities",
      "params": {
        "country_code": "US"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "rank": 1,
          "city_id": "c2753900",
          "name": "Downtown-PennQuarter-Chinatown",
          "slug": "downtown-pennquarter-chinatown-united-states"
        },
        …
      ],
      "count": 96
    }
  3. 3Rows

    rankcity_idnameslug
    1c2753900Downtown-PennQuarter-Chinatowndowntown-pennquarter-chinatown-united-states
    2c2728343CivicCenterciviccenter-united-states
  4. 4CSV

    instagram-location_cities-sample.csv rank,city_id,name,slug,url,country_code,country_name,platform

A request with country_code goes in. One response returns a page of that country's cities from the places directory, each row with city_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 country code US, captured November 21, 2026 at 07:18 (UTC), that returned 96 rows. Your own calls return these fields as listed in the field reference.

rankcity_idnameslugurlcountry_codecountry_nameplatform
1c2753900Downtown-PennQuarter-Chinatowndowntown-pennquarter-chinatown-united-stateshttps://www.instagram.com/explore/locations/c2753900/downtown-pennquarter-chinatown-united-states/USUnited Statesinstagram
2c2728343CivicCenterciviccenter-united-stateshttps://www.instagram.com/explore/locations/c2728343/civiccenter-united-states/USUnited Statesinstagram

Use cases

  • List the cities of a country

    Give one country_code and read the cities under that country in the places directory.

  • Go on to the places

    Pass city_id to city_locations to list the places in a city.

  • Match the directory pages

    Use slug and url to match the pages in the Instagram places directory.

  • Go country by country

    Change country_code and list the cities one country at a time.

Instagram Graph API vs EveryInfra

Here is how the official Instagram Graph API and EveryInfra location_cities compare on platform scope and on access review.

ComparedInstagram Graph APIEveryInfra
Platform scope"The Instagram Platform is a collection of APIs that allows your app to access data for Instagram professional accounts, including business and creator accounts."It reads the cities in the Instagram places directory, which is not the data of any professional account. You do not need to connect an Instagram account to your app first.
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

  • country_code is required: two letters (ISO 3166-1), such as US, JP or GB, in upper or lower case.
  • The result is the cities under that country in the Instagram places directory. A country 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.
  • country_name is the English name of the country, such as United States.
  • city_id is c plus digits, such as c2728325. Pass it to city_locations.

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": "location_cities",
  "params": {
    "country_code": "US"
  }
}'

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 location_cities, 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 Cities in a country endpoint (instagram/location_cities).

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 location_cities, and put the parameters inside params.
- Required parameters:
  - country_code: A two-letter country code (ISO 3166-1), such as US, JP or GB; any letter case works.
- Optional parameters:
  - page_token: Page token for location_cities. 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…), city_id (City ID, c followed by digits, such as…), name, slug (The name part of the Instagram location…), url, 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": "location_cities",
  "params": {
    "country_code": "US"
  }
}
- 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.
actionbodystringYeslocation_citiesCapability identifier, fixed value.
country_codebody.paramsstringYes-A two-letter country code (ISO 3166-1), such as US, JP or GB; any letter case works.
page_tokenbody.paramsstringNo-Page token for location_cities. 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": "location_cities",  "results": [    {      "rank": 1,      "city_id": "c2753900",      "name": "Downtown-PennQuarter-Chinatown",      "slug": "downtown-pennquarter-chinatown-united-states",      "url": "https://www.instagram.com/explore/locations/c2753900/downtown-pennquarter-chinatown-united-states/",      "country_code": "US",      "country_name": "United States",      "platform": "instagram"    },    {      "rank": 2,      "city_id": "c2728343",      "name": "CivicCenter",      "slug": "civiccenter-united-states",      "url": "https://www.instagram.com/explore/locations/c2728343/civiccenter-united-states/",      "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.
city_idCity ID, c followed by digits, such as c2728325. Pass it to city_locations.
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.
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 cities-in-a-country API return?

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

How do I write country_code?

Use a two-letter country code (ISO 3166-1), such as US, JP or GB, in upper or lower case.

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 country_code. No Instagram login or access token is needed.

You can call the other Instagram endpoints with the same key, such as city_locations to list the places in one city.

Google Analytics needs consent. Privacy