instagram/
location-search

The Instagram Location Search API finds Instagram locations by place name or by latitude and longitude, returning location IDs with names, addresses, cities, and coordinates for follow-up lookups.

Instagram Location Search API

Name or coordinates
Location IDs
Nearby places
0.5 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Instagram Location Search

Instagram keeps its own catalog of places, and every location tag on a post points to one entry in that catalog by its ID. Searching the catalog by name or by a point on the map is how a venue, a street, or a pair of coordinates becomes the ID Instagram uses for its location pages and tagged posts.

Instagram Location Search API Features

  • Search by nameType a place name, landmark, or city into query and the Instagram Location Search API returns the matching locations with their IDs.
  • Search around a pointSend latitude and longitude to list the locations around that spot, each with a distance label in extra.distance.
  • Ready for the next stepEvery match includes the location ID, page URL, name, address, city, latitude, and longitude, so it can go straight into a details or posts request.

Instagram Location Search API Parameters

ParametersRequiredDescription
queryRequired (at least one)Place name, landmark, or city, up to 100 characters. Use this or latitude and longitude.
latitudeRequired (at least one)Latitude of the point to search around, from -90 to 90. Send it together with longitude.
longitudeRequired (at least one)Longitude of the point to search around, from -180 to 180. Send it together with latitude.

How to Use the Instagram Location Search API

Query the Instagram Location Search API by name or coordinates, pick the right match, and reuse its ID.

  1. Decide whether you are searching by the place's name or by its coordinates.
  2. POST {"query": "Times Square"} or {"latitude": 40.758, "longitude": -73.9855} to /v1/instagram/location-search.
  3. Poll GET /v1/tasks/{task_id} until status is succeeded and read results.items.
  4. Pick the match by its city and coordinates, and keep its id for Instagram Location Info or Instagram Location Posts.
curl -X POST "https://api.socq.ai/v1/instagram/location-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Times Square"}'

# To search around a point instead: -d '{"latitude":40.758,"longitude":-73.9855}'
# Matching locations are returned by GET /v1/tasks/{task_id}.

Instagram Location Search API Use Cases

  • Turning venue lists into IDs: Run a spreadsheet of store, hotel, or venue names through the Instagram Location Search API to get the location IDs you need for posts and details.
  • Mapping a neighborhood: Search around the coordinates of a campus, mall, or event site to list the Instagram locations close by.
  • Cleaning up duplicate places: Compare names and coordinates to spot several Instagram locations that point to the same real place, then collect posts from each of them.

Instagram Location Search API Pro Tips

  • Include the city in query when a place name is common, for example "Central Park New York".
  • Confirm the right Instagram Location Search API result by its city and coordinates before you reuse its ID.
  • When you know exactly where a place is, search by coordinates; the results list the locations around that point along with their distance.

Beyond the Instagram Location Search API, use these APIs when you need a different type of public Instagram data.

  • Instagram Search API — Search public profiles by keyword or handle with identity and visible account signals.
  • Instagram Hashtag Posts API — Discover public posts by hashtag with source-tag context, media, creators, timestamps, and visible engagement.
  • Instagram Reels Search API — Search public Reels by text query with captions, creators, media, timestamps, visible engagement, and query context.
  • Instagram Location Info API — Look up one location by ID or location page URL, with name, category, phone, coordinates, and tagged post count.
  • Instagram Location Posts API — Collect top or most recent public posts tagged at a location, with captions, authors, engagement, and media.
  • Instagram Hashtag Search API — Find hashtags matching a keyword, with hashtag names, IDs, tag page URLs, and public post counts.

Explore other platforms

Combine Instagram data with public data from other supported social platforms.

Instagram Location Search API — FAQ

Instagram Location Search API is a programmatic interface for finding Instagram locations by a place name or by latitude and longitude. It returns location IDs together with names, location page URLs, addresses, cities, and coordinates.

Search for the place by name or coordinates with the Instagram Location Search API; the id field of each result is the location ID Instagram uses for its location pages.

Yes. Send latitude and longitude together, and the task returns the locations around that point.

Each Instagram Location Search API call costs 0.5 credits, however many locations it returns.