All questionsInstagram

How do I get Instagram posts by location?

Two calls. Search places with GET /v1/instagram/search/places?q=… to find the location and its ID. Then call GET /v1/instagram/locations/{id}/posts with sort=recent or sort=top. Each request returns one page of public posts tagged at that place.

The Graph API has no location feed for places you do not own. This is public data as the location page shows it, read on request.

Checked September 2026 · request and response run against the API · no affiliate links

Get started for $0 Quickstart

GET /v1/instagram/locations/{id}/posts?sort=recent

curl "https://api.openhandle.dev/v1/instagram/locations/950000000002/posts?sort=recent" \
  -H "Authorization: Bearer $OPENHANDLE_API_KEY"

TypeScript SDK

import { OpenHandle } from '@openhandle/sdk';

const openhandle = new OpenHandle({ apiKey: process.env.OPENHANDLE_API_KEY! });
const places = await openhandle.instagram.search.places.list({ q: 'synthetic' });
const location = places.data[0];

let page = await openhandle.instagram.location(location.id).posts.list({ sort: 'recent' });
for (const post of page.data) console.log(post.author.handle, post.createdAt);

200 OK

{
  "platform": "instagram",
  "resource": "post",
  "capturedAt": "2026-09-18T11:40:27Z",
  "source": "live",
  "data": [
    {
      "id": "910100000001",
      "createdAt": "2026-08-09T15:30:00Z",
      "author": { "id": "910000000001", "handle": "northstar_forge_test" },
      "location": { "id": "950000000002", "name": "Synthetic Harbor" },
      "metrics": { "likes": 840, "comments": 5 }
    }
  ],
  "meta": { "cursors": { "next": "b3BhcXVlLWN1cnNvcg" } }
}

Trimmed to one post. The example is a Test place with paginated posts, so you can run both calls on a free Test key.

Find the location first

—Search by name. GET /v1/instagram/search/places?q=blue bottle returns matching places with ID, name, address, and coordinates.
—Read the place. GET /v1/instagram/locations/{id} returns the place itself: name, address, coordinates, category, and website where Instagram shows them.
—From a post. A post tagged at a place carries location.id. Use it directly.

Recent or top

—recent. Newest public posts tagged there. Use it for venue monitoring and local UGC on a schedule.
—top. The posts Instagram ranks highest for the place.

What a location feed is not

It is posts the author tagged at that place. It is not GPS data and not every photo taken there. Posts from private accounts never appear. A post can be tagged at a place the author never visited. Treat it as what people chose to say, not where they were.

When this does not work

Empty is an answer. A cursor from another request is a mistake.

Situation	Status	Code
The place has no public posts	200	empty data
The location ID does not exist	404	PROFILE_NOT_FOUND
The cursor came from another place, sort, or freshness	400	CURSOR_MISMATCH

400 Bad Request

{
  "error": {
    "code": "CURSOR_MISMATCH",
    "message": "The cursor does not belong to this request.",
    "requestId": "req_01j8…",
    "retryable": false
  }
}

An empty page bills as an answered request. Both the search and the feed are billed per request.

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents

Get started for $0 Read the quickstart