Instagram Location Posts API. Recent or top posts, page by page.
Recent or top posts tagged at a location. We handle the proxies, blocks and platform changes.
Instagram Location Posts API at a glance
Returns the recent or top public Instagram posts tagged at a location, from its link or ID. Each has its caption, hashtags, mentions, publish time, photos or videos, author, the place it's tagged at with its coordinates, and like and comment counts.
GET /v1/instagram/place_posts
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 22 typed fields null when unknown
- 18 recent or top posts per page, newest first
urlis all it needs, e.g.https://www.instagram.com/explore/locations/212988663/new-york-new-york/
Send one request. Get up to 18 recent or top posts back.
Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.
$ npm install socialtapurl = https://www.instagram.com/explore/locations/212988663/new-york-new-york/const params = new URLSearchParams({
url: "https://www.instagram.com/explore/locations/212988663/new-york-new-york/",
});
const res = await fetch(`https://socialtap.dev/v1/instagram/place_posts?${params}`, {
headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/instagram/place_posts",
params={"url": "https://www.instagram.com/explore/locations/212988663/new-york-new-york/"},
headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/instagram/place_posts")
uri.query = URI.encode_www_form('url' => 'https://www.instagram.com/explore/locations/212988663/new-york-new-york/')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'url' => 'https://www.instagram.com/explore/locations/212988663/new-york-new-york/',
]);
$ch = curl_init('https://socialtap.dev/v1/instagram/place_posts?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("url", "https://www.instagram.com/explore/locations/212988663/new-york-new-york/")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/instagram/place_posts?"+q.Encode(), nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var body struct {
Data json.RawMessage `json:"data"`
Page json.RawMessage `json:"page"`
Meta map[string]any `json:"meta"`
Error *struct {
Code string `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
log.Fatal(err)
}
if body.Error != nil {
log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
}
fmt.Println(string(body.Data), body.Meta["credits_charged"])
}curl -G 'https://socialtap.dev/v1/instagram/place_posts' \
--data-urlencode 'url=https://www.instagram.com/explore/locations/212988663/new-york-new-york/' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [],
"author": {
"avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-19/670615930_18077945933214471_2345937301934877217_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=102&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_gid…",
"display_name": null,
"id": "36427582470",
"is_verified": false,
"url": "https://www.instagram.com/fillysto/",
"username": "fillysto"
},
"coauthors": [],
"duration_ms": 7986,
"hashtags": [
"feet",
"viral"
],
"id": "DfPS-ByN6tu",
"is_nsfw": null,
"is_pinned": false,
"is_sponsored": false,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 7986,
"expires_at": "2026-10-25T18:00:00Z",
"height": 2560,
"thumbnail_url": "https://scontent-atl3-2.cdninstagram.com/v/t15.5256-10/825321038_4587988858127297_3075286220731044235_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=105&ig_cache_key=NDAyMTUxNjQxOTYyNjE1MDc2Ng%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23…",
"type": "video",
"url": "https://scontent-atl3-2.cdninstagram.com/o1/v/t16/f2/m84/AQOv7yoNMI4v8okLQJoZ8jAFSp0iwJaRGT2wxLwLbfNNd5pCUSBXNkJMplQrFHSEt_1jB-tYKIydqZcd58pJveU5akKoxvHPaFHsxso.mp4?_nc_cat=105&_nc_sid=SCRUBBED&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_ohc=SCRUBBED&efg=SCRUBBED&ccb=SCRUBBED&vs=…",
"width": 1440
}
],
"mentions": [],
"metrics": {
"comment_count": 0,
"like_count": 0,
"quote_count": null,
"repost_count": null,
"save_count": null,
"share_count": null,
"view_count": null
},
"platform": "instagram",
"platform_specific": {
"instagram": {
"is_ai_generated": false,
"link": null,
"location": {
"id": "108424279189115",
"latitude": 40.7142,
"longitude": -74.0064,
"name": "New York, New York",
"url": "https://www.instagram.com/explore/locations/108424279189115/"
}
}
},
"platform_type": "reel",
"published_at": "2026-11-02T12:22:37Z",
"text": "Here, I think this belongs with you 🌸🤍 #feet #viral",
"thumbnail_url": "https://scontent-atl3-2.cdninstagram.com/v/t15.5256-10/825321038_4587988858127297_3075286220731044235_n.jpg?stp=c0.248.640.640a_dst-jpg_e15_tt6&_nc_cat=105&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-2.cdninstagram.co…",
"title": null,
"type": "video",
"unknown_fields": [],
"url": "https://www.instagram.com/reel/DfPS-ByN6tu/"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-19/831049335_18495629779097128_2536839403660674104_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=104&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_gid…",
"display_name": "Menzi Palabrica",
"id": "3064185127",
"is_verified": false,
"url": "https://www.instagram.com/menzip2/",
"username": "menzip2"
},
"coauthors": [],
"duration_ms": null,
"hashtags": [],
"id": "DfPS91OowzA",
"is_nsfw": null,
"is_pinned": false,
"is_sponsored": false,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": null,
"expires_at": "2026-10-25T18:00:00Z",
"height": 2250,
"thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/881396693_18502576525097128_3767119897427082798_n.jpg?stp=c0.225.1800.1800a_dst-jpg_e35_s1080x1080_sh2.08_tt6&_nc_cat=106&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-…",
"type": "image",
"url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/881396693_18502576525097128_3767119897427082798_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=106&ig_cache_key=NDAyMTUxNjQwNjE0NDMwNjM2OA%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=…",
"width": 1800
}
],
"mentions": [],
"metrics": {
"comment_count": 0,
"like_count": 0,
"quote_count": null,
"repost_count": null,
"save_count": null,
"share_count": null,
"view_count": null
},
"platform": "instagram",
"platform_specific": {
"instagram": {
"is_ai_generated": false,
"link": null,
"location": {
"id": "108424279189115",
"latitude": 40.7142,
"longitude": -74.0064,
"name": "New York, New York",
"url": "https://www.instagram.com/explore/locations/108424279189115/"
}
}
},
"platform_type": "post",
"published_at": "2026-11-02T12:22:20Z",
"text": null,
"thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/881396693_18502576525097128_3767119897427082798_n.jpg?stp=c0.225.1800.1800a_dst-jpg_e35_s1080x1080_sh2.08_tt6&_nc_cat=106&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-…",
"title": null,
"type": "image",
"unknown_fields": [],
"url": "https://www.instagram.com/p/DfPS91OowzA/"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.75761-19/503021357_17842805697506767_3789080071039190930_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_gid…",
"display_name": "Crafted by soul",
"id": "75164714766",
"is_verified": false,
"url": "https://www.instagram.com/craftedbysoul1/",
"username": "craftedbysoul1"
},
"coauthors": [],
"duration_ms": 64180,
"hashtags": [
"LandscapeArt",
"ForestPainting",
"ContemporaryArt"
],
"id": "DfPSd32NYBy",
"is_nsfw": null,
"is_pinned": false,
"is_sponsored": false,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 64180,
"expires_at": "2026-10-25T18:00:00Z",
"height": 1280,
"thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/886235102_1787688402535983_6238101915428221736_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=110&ig_cache_key=NDAyMTUxNDIwOTkzMjQ0Mzc2MjE4NzgzNTE5NjY2MjYzNjk%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc…",
"type": "video",
"url": "https://scontent-atl3-2.cdninstagram.com/o1/v/t2/f2/m86/AQO2UtArmmTTXAoGU-k2d313na9iIqF9zDiCSgK-vjEWL7dnmqXZ3PUKUnh-5bfAD8v41YVPKM2LPB5W6rF-02C1W8JUft0IIHBDZG0.mp4?_nc_cat=111&_nc_sid=SCRUBBED&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_ohc=SCRUBBED&efg=SCRUBBED&ccb=SCRUBBED&vs=S…",
"width": 720
}
],
"mentions": [
"a.zabrodzka"
],
"metrics": {
"comment_count": 0,
"like_count": 0,
"quote_count": null,
"repost_count": null,
"save_count": null,
"share_count": null,
"view_count": null
},
"platform": "instagram",
"platform_specific": {
"instagram": {
"is_ai_generated": false,
"link": null,
"location": {
"id": "108424279189115",
"latitude": 40.7142,
"longitude": -74.0064,
"name": "New York, New York",
"url": "https://www.instagram.com/explore/locations/108424279189115/"
}
}
},
"platform_type": "reel",
"published_at": "2026-11-02T12:22:19Z",
"text": "Agnieszka Zabrodzka is a Polish contemporary painter based in Warsaw, known for atmospheric forest landscapes, mirrored water reflections, and dreamlike scenes featuring white deer and cranes. Her acrylic paintings blend traditional landscape influences with Japanese-inspired gra…",
"thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/886235102_1787688402535983_6238101915428221736_n.jpg?stp=c0.248.640.640a_dst-jpg_e15_tt6&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-1.cdninstagram.c…",
"title": null,
"type": "video",
"unknown_fields": [],
"url": "https://www.instagram.com/reel/DfPSd32NYBy/"
}
],
"page": {
"has_more": false,
"next_cursor": null,
"next_cursor_expires_at": null,
"end_reason": "platform_limit"
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "instagram",
"source": "page",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 971,
"fetched_at": "2026-10-25T12:00:00Z",
"input": {
"kind": "place",
"id": "212988663",
"url": "https://www.instagram.com/explore/locations/212988663/new-york-new-york/"
},
"credits_remaining": 9999,
"client_request_id": null,
"warnings": []
}
}import { SocialTap } from "socialtap";
const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY
const res = await client.instagram.placePosts.list({ url: "https://www.instagram.com/explore/locations/212988663/new-york-new-york/" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "url=" + encode("https://www.instagram.com/explore/locations/212988663/new-york-new-york/");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/instagram/place_posts?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"url=" + Uri.EscapeDataString("https://www.instagram.com/explore/locations/212988663/new-york-new-york/"));
var res = await http.GetAsync("https://socialtap.dev/v1/instagram/place_posts?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/instagram/place_posts")
.query(&[("url", "https://www.instagram.com/explore/locations/212988663/new-york-new-york/")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/instagram/place_postsLong arrays and strings are shortened here. Real responses are complete.Docs One schema on 21 platforms.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field Instagram doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
An Instagram location link (instagram.com/explore/locations/212988663/new-york-new-york/, as a post's location tag opens it; any name or tab after the ID) or the location's numeric ID (the number in that link).
Write one parser
Instagram, TikTok, Facebook and 18 more platforms answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (tiktok, youtube, …).
idstring- Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring- Canonical post URL.
typestring- Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring- The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring- Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring- Caption, description or body as plain text.
languagestring- BCP-47 language of text, when the platform states it.
Live data from 33 platforms.
What teams build with the Instagram Location Posts API.
Monitor posts at a venue, store or attraction
Find creators posting from a city
Measure a location's engagement on Instagram
Good to know before you build.
- Logged out, Instagram shows only the first page of a location's posts, so the list ends with end_reason platform_limit.
- Some locations show logged-out visitors an empty Recent tab, or both tabs empty. That page ends with platform_limit, and sort=popular may have posts.
- sort=popular is Instagram's Top tab. For a city or an area it includes posts tagged at places inside it, each named in platform_specific.instagram.location.
- view_count is null because location pages don't show play counts. Like and comment counts are exact, and like_count is null when the author hides it.
1 credit per page. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful page | Per 1,000 pages |
|---|---|---|
Public page page | 1 credit | $0.75–$1.97 |
- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.
Questions about the Instagram Location Posts API.
More in the API reference.
How much does the Instagram Location Posts API cost?
A page of up to 18 recent or top posts costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.
How do I get the next page?
Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours.
Try it on a link you already have.
Paste it in the playground, or copy the request into your code.
100free credits
- No credit card
- Failed requests are free
- Works on all 218 endpoints