instagram/
location-posts

The Instagram Location Posts API collects public posts and reels tagged at an Instagram location by ID or URL, returning captions, authors, likes, comments, media, and timestamps, ordered by top or recent.

Instagram Location Posts API

Location ID or URL
Top or recent
Carousel media
0.5 credits / result
Ready
Ready

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

README

By SocQ · Updated

Instagram Location Posts

Location posts are the photos and reels people tag with a place, from a corner café to a stadium on match day, each with a caption, author, likes, comments, and media. Following them shows what people share at a place as it happens, which helps with local trend research, event coverage, and finding the creators who post from a particular spot.

Instagram Location Posts API Features

  • Posts for one placeGive the Instagram Location Posts API a location_id or a location page link and get the public posts and reels tagged there.
  • Top or recentsort_by top returns the posts Instagram ranks highest for the place, while recent returns the newest ones first and keeps going until results_limit.
  • The whole postEach post includes its shortcode, link, caption, author, like and comment counts, posting time, and image or video media, with every slide of a carousel listed.
  • The place travels with the postextra.location_id and extra.location_name keep the location attached to each record, which helps when you combine several places.

Instagram Location Posts API Parameters

ParametersRequiredDescription
location_idRequired (at least one)Numeric ID of the place whose tagged posts you want. Use this or url.
urlRequired (at least one)Link to the location page, for example https://www.instagram.com/explore/locations/212988663/. Use this or location_id.
sort_byOptionaltop for the place's highest-ranked posts (the default), or recent for the newest posts first.
results_limitOptionalHow many posts to return, from 1 to 100. Defaults to 20.

How to Use the Instagram Location Posts API

Choose a place and an order, run an Instagram Location Posts API task, and read the posts.

  1. Find the location ID with Instagram Location Search, or copy the location page link.
  2. POST the location_id, a sort_by of top or recent, and a results_limit to /v1/instagram/location-posts.
  3. Poll GET /v1/tasks/{task_id} until status is succeeded.
  4. Read the posts from results.items and follow results.next_cursor for the rest.
curl -X POST "https://api.socq.ai/v1/instagram/location-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_id":"384695225271379","sort_by":"top","results_limit":20}'

# Switch sort_by to "recent" for the newest posts first.
# The posts are returned by GET /v1/tasks/{task_id}.

Instagram Location Posts API Use Cases

  • Event coverage: Collect recent posts at a stadium, concert venue, or festival site with the Instagram Location Posts API while the event runs to gather photos, captions, and reactions.
  • Local trend spotting: Review recent captions and media at a neighborhood or landmark to see what people are talking about there this week.
  • Finding local creators: Use the authors of a place's top posts to build a list of creators who publish from that location.

Instagram Location Posts API Pro Tips

  • Use sort_by recent when you need more than a quick snapshot; it pages through as many posts as results_limit allows.
  • Schedule recent runs of the Instagram Location Posts API and keep the post ids you have already seen, so each run adds only new posts.
  • Hand interesting post URLs to Instagram Comments or Instagram Post Likers to see the conversation and audience behind them.

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

  • Instagram Posts API — Collect public posts, media, hashtags, mentions, timestamps, and engagement by username.
  • Instagram Reels API — Collect public Reels, media, audio, hashtags, mentions, and engagement by username.
  • Instagram Comments API — Collect public comments, authors, timestamps, likes, and replies from post URLs.
  • Instagram Post Info API — Look up known public post, Reel, or legacy IGTV URLs with captions, author identity, media, timestamps, visible engagement, and input context.
  • Instagram Post Likers API — List accounts from the visible likers list of a post URL, with usernames, names, avatars, and verification status.
  • Instagram Location Info API — Look up one location by ID or location page URL, with name, category, phone, coordinates, and tagged post count.

Explore other platforms

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

Instagram Location Posts API — FAQ

Instagram Location Posts API is a programmatic interface for collecting public posts tagged at an Instagram location, using its location ID or location page URL as input. It returns post links, captions, authors, like and comment counts, media, and posting times, ordered as top or recent posts.

Find the place's location ID with Instagram Location Search API, then send it here with sort_by set to top or recent.

top returns the posts Instagram ranks highest for the place, while recent returns the newest tagged posts first and pages until results_limit is reached.

Up to 100 with sort_by recent; results_limit defaults to 20.

The Instagram Location Posts API charges 0.5 credits for each post returned.