API reference

Utilities — Fetch by social URL

Fetch the typed public resource represented by a supported social URL.

Parse a supported Instagram, TikTok, or Twitter URL locally, then execute the same typed read as the canonical data endpoint. URL parsing is free; the resolved data read uses normal Test or Live accounting and never follows redirects.

Request

curl "https://api.openhandle.dev/v1/urls/fetch" \
  -X POST \
  -H "Authorization: Bearer $OPENHANDLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/p/Db04otPRpRH/?igsi=NjJteXVldjVmNDdk","freshness":"24h"}'

The TypeScript and Go tabs use the official SDKs.

Response

The response is the same typed public envelope returned by the canonical profile, post, story, or highlight endpoint. Content-Location contains that canonical path. Test keys still return Openhandle-Cost: 0.000; Live keys use the resolved operation's normal price. Unknown domains, reserved application paths, and short links that require a redirect return INVALID_URL.

See Fetching by URL for the complete identifier rules.

Twitter — Search suggestions

Search suggestions from public Twitter data.

Envelope and errors

Every Openhandle response uses one envelope. Every error has a code, a request ID, and a retry rule.

On this page

RequestResponse