Locations

Search physical places to get a valid location_id for tagging a post. The platform query parameter selects the source, and the two sources use DIFFERENT ids (a Facebook Place ID is not a Threads location id), so always search with the platform you will tag.

platform=instagram (default): search by name (q). Returns only real venues with a precise address (the kind Instagram accepts); national brand pages, personal profiles, and Instagram location IDs are not returned because Instagram rejects them. Pass a returned id as the top-level location_id on POST /posts/create. Requires a Facebook account connected to the workspace (the lookup runs through Facebook's place data). Response shape: { data: [...], error, needsPermission }.

platform=threads: search by name (q) OR by coordinates (latitude + longitude). Pass a returned id as threads.location_id on POST /posts/create / PATCH /posts/{id}. Requires a Threads account connected with the threads_location_tagging permission (connections made before that permission was added must be reconnected; the response then carries error.code = threads_reauth_required). Threads allows 500 location searches per account per rolling 24 hours. Response shape: { locations: [...] } or { error: { code, message } }.

Check whether a Facebook Place ID is a valid Instagram location (a single venue with a precise address) before using it as location_id. Returns { valid: true, name, address } for taggable places; { valid: false, reason } for personal profiles, brand pages, or non-places. If the workspace has no Facebook account (or the app can't read the page), returns { valid: false, unverified: true }, and the post's publish step is then the final check.