places

Unfurl Place From Url

Extract place data from any URL.

Runs the full extraction pipeline (JSON-LD → OG tags → Claude AI → Google Places) and returns structured place data.

When the pipeline fully resolves a place, the Place + PlaceSource are saved immediately and saved_place_id is set in the response. For unresolved results only the preview is returned — the client shows a confirmation card and then POSTs to /places to save.

post/api/v1/places/unfurl

Request

Base URL: https://yondry.app (the document declares no server; this is the origin it was published from)
URL: https://yondry.app/api/v1/places/unfurl
Auth: HTTP bearer

Request body

urlstring required

Any URL to extract place data from

caption_hintstring nullable

Optional plain-text caption pasted by the user (e.g. from Instagram). Used as primary AI input when the server cannot fetch the page directly.

Response

Successful Response

source_urlstring required

resolvedboolean required

paywalledboolean

namestring nullable

addressstring nullable

latnumber nullable

lonnumber nullable

categorystring nullable

notesstring nullable

thumbnail_urlstring nullable

caption_excerptstring nullable

google_place_idstring nullable

saved_place_idstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.