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
| Parameters | Required | Description |
|---|---|---|
query | Required (at least one) | Place name, landmark, or city, up to 100 characters. Use this or latitude and longitude. |
latitude | Required (at least one) | Latitude of the point to search around, from -90 to 90. Send it together with longitude. |
longitude | Required (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.
- Decide whether you are searching by the place's name or by its coordinates.
- POST {"query": "Times Square"} or {"latitude": 40.758, "longitude": -73.9855} to /v1/instagram/location-search.
- Poll GET /v1/tasks/{task_id} until status is succeeded and read results.items.
- 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.
Related APIs
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Account Age Checker API