Utilities — Fetch by 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, Python, Go, PHP, and Rust 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.