Skip to main content
POST
Resolve a social oEmbed
Send a Pirehub API key with oembed:read in x-pirehub-api-key or as a bearer token. OAuth tokens require the same scope. See Authentication. The JSON body accepts only url. Supported providers are X, Facebook, Instagram, Threads, TikTok, and Reddit. Response fields may be null when unavailable. X currently returns metadata with embed.html: null and embed.scripts: []. Treat provider HTML as untrusted and render it in an isolated, sandboxed iframe. Use capabilities to determine which rendering options are available. See the oEmbed guide for authentication, response examples, provider URL formats, caching, and errors.

Authorizations

Authorization
string
header
required

OAuth 2.0 Authorization Code with PKCE, issued by Pirehub's Clerk authorization server. Request only the scopes required by the operation.

Body

application/json
url
string<uri>
required

Public provider post URL. Trimmed, normalized to HTTPS, and checked against allowed hosts and public network destinations. Replace the example placeholders with a real post.

Required string length: 1 - 2048

Response

Normalized oEmbed data in the standard success envelope; provider-specific metadata is omitted.

success
any
required
data
object
required