SOCIAL MEDIA

Instagram Discover Location Posts API

Get 50-95 post shortcodes from a location page. No auth needed. Use with get-post-commenters for massive lead discovery.

Part of: Instagram Post Scraper API

instagramlocationdiscoveryleadssocial
Try it freeGet an API key

How to call it

Send one POST to api.upapi.io/instagram-discover-location.post with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 15 weighted units of your monthly quota. The operation times out after 30 seconds. Identical requests are served from cache for 600 seconds, unbilled.

endpoint
POST https://api.upapi.io/instagram-discover-location.post

Instagram Discover Location Posts API reference

Request parameters

proxyUrl
string — Optional proxy URL
locationId
stringrequired — Instagram location ID (numeric)

Response fields

posts
arrayrequired
posts[].pk
stringrequired
posts[].postUrl
stringrequired
posts[].shortcode
stringrequired
success
booleanrequired
latitude
number
elapsedMs
integerrequired
fetchedAt
stringrequired
longitude
number
locationId
stringrequired
locationName
stringrequired

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body
{
  "locationId": "example"
}
json — example response shape
{
  "posts": [
    {
      "pk": "example",
      "postUrl": "example",
      "shortcode": "example"
    }
  ],
  "success": false,
  "latitude": 43.65,
  "elapsedMs": 1,
  "fetchedAt": "example",
  "longitude": -79.38,
  "locationId": "example",
  "locationName": "example"
}

Code snippets

cURL
curl
curl -X POST https://api.upapi.io/instagram-discover-location.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "locationId": "example" }'
JavaScript
javascript
const response = await fetch('https://api.upapi.io/instagram-discover-location.post', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "locationId": "example"
}),
});

const data = await response.json();
console.log(data);
Python
python
import requests

response = requests.post(
    'https://api.upapi.io/instagram-discover-location.post',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "locationId": "example"
},
)

print(response.json())
Go
go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "locationId": "example" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/instagram-discover-location.post", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}
PHP
php
<?php

$payload = json_encode([
    'locationId' => 'example',
]);

$ch = curl_init('https://api.upapi.io/instagram-discover-location.post');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);
Ruby
ruby
require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/instagram-discover-location.post')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "locationId": "example" }.to_json

response = http.request(request)
puts JSON.parse(response.body)
Java
java
import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"locationId\": \"example\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/instagram-discover-location.post")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}
C#
csharp
using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"locationId\": \"example\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/instagram-discover-location.post", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Instagram Discover Location Posts API cost per call?

Each call spends 15 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the Instagram Discover Location Posts API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are Instagram Discover Location Posts API responses cached?

Yes — identical requests are served from cache for 600 seconds, and a cache hit is not billed.

More Social Media APIs

Browse every Social Media API →