social.colibri.beta.embed.getMetadata

Fetches and parses a link preview. The AppView fetches the URL on the client's behalf, so the client's address is never exposed to the target site.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority

Details · query

Compare Edit in builder → Fork →

Query

query · GET

query string

requiredstring · uri

The URL to preview.

application/json

requiredref

The parsed preview.

Reference

The request has no valid service auth.

The arguments are inconsistent or malformed beyond schema validation.

The target refused the request, timed out, or resolves to an address the AppView will not fetch.

The target site failed while the AppView fetched or parsed it.

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

social.colibri.embed.getMetadata
query not from the namespace authority

Fetches Open Graph-style link preview metadata for a URL.
app.bsky.embed.getEmbedExternalView
query

Resolve one AT-URI record into the data needed to render an enhanced external embed. The records are validated against the requested `url` before any view is built. When validation passes, returns `data`, `associatedRefs` (strongRefs to embed into a post's external.associatedRefs) and the raw `associatedRecords`, plus a legacy `view` for Standard.site records only. When validation fails, only `unverifiedAssociatedRefs` and `unverifiedAssociatedRecords` are returned and no view or data is built.
town.delve.embed.getEmbedExternalView
query not from the namespace authority

Resolve one or more AT-URIs into the data needed to render an enhanced external embed. Returns `associatedRefs` (strongRefs to embed into a post's external.associatedRefs), the raw `associatedRecords`, and a hydrated `view`. The response is empty (`{}`) when no records were resolvable, or when validation determined the resolved records don't actually back the requested URL; clients should fall back to their own link-card rendering in that case and skip writing strongRefs to the post.
social.colibri.embed.getImage
query not from the namespace authority

Proxies and returns an external image, guarding against SSRF.