get/locations

Locations by city ID

🗺️ Location Data

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access Instagram data through agntdata: Locations by city ID. List locations available in a specific city. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need user profiles, reels, explore, locations, and hashtag media programmatically.

Use cases

AI agents that need Instagram data in structured form

Analytics and monitoring pipelines for Instagram content

Research and GTM workflows that combine Instagram signals with other data

Parameters

Name	In	Type	Required	Description
page	query	number	optional	—Default: `1`
fields	query	string	optional	Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data.
city_id	query	string	required	—Default: `c2728325`

Responses

Successful response

{
  "type": "object"
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Locations_by_city_ID",
  "method": "get",
  "path": "/locations",
  "summary": "Locations by city ID",
  "description": "List locations available in a specific city.",
  "parameters": [
    {
      "name": "page",
      "in": "query",
      "required": false,
      "schema": {
        "type": "number",
        "default": "1"
      }
    },
    {
      "name": "fields",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      },
      "description": "Use the `fields` parameter to reduce bandwidth consumption and minimize response size by returning only the necessary data."
    },
    {
      "name": "city_id",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "c2728325"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Successful response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Bad request"
    },
    {
      "statusCode": "401",
      "description": "Unauthorized - invalid API key"
    },
    {
      "statusCode": "429",
      "description": "Rate limit exceeded"
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Start for free

Related endpoints

getLocation info by location ID

/location-info

getWeb profile info by username

/web-profile

getMusic info by music ID

/music

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

Get started for free View all endpoints

Instagram APIInstagram data APIlocations by city id APIAI agents data APIInstagram APIInstagram data APIInstagram for AI agents

Back to Instagram