Instagram — List profile posts

Return a stable page of posts for one public profile.

The API key selects Test or Live. Do not send an environment header, parameter, or tool argument. null means unavailable, not zero.

Find compatible test data before you need another state.

The TypeScript and Go tabs use the official SDKs.

Request

Test

curl "https://api.openhandle.dev/v1/instagram/profiles/@northstar_forge_test/posts?freshness=24h" \
  -H "Authorization: Bearer $OPENHANDLE_TEST_KEY"

Expected: HTTP 200, Openhandle-Environment: test, Openhandle-Cost: 0.000, and dataset 2026-09-07.1. Fixture: instagram.profile.northstar-forge.

Live

curl "https://api.openhandle.dev/v1/instagram/profiles/@$USERNAME/posts?freshness=24h" \
  -H "Authorization: Bearer $OPENHANDLE_LIVE_KEY"

Live uses the same response schema and errors. It uses real public identifiers and normal billing.

Common parameters

• freshness: live, 24h (default), 7d, or 30d.
• cursor: opaque meta.cursors.next value from the previous page.
• since: optional RFC 3339 timestamp.

Answered Test results—including private and not-found answers—record a $0.000 actual charge and a separate live-equivalent price. Authentication, validation, rate-limit, service, and internal failures create request history only.