Locations
Search and attach location tags (such as Instagram place tags) to posts.
Search Instagram-taggable locations
Search physical places by name to get a valid location_id for tagging an Instagram post. 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 location_id on POST /posts/create. Requires a Facebook account connected to the workspace (the lookup runs through Facebook's place data).
query Parameters
qPlace name to search (min 2 chars), e.g. a dealership, café, or venue name. Use a specific name — generic brands return their individual store locations, not the brand.
Search Instagram-taggable locations › Responses
Matching places
errorSet when search is unavailable (e.g. no Facebook account connected, or the app lacks place-search permission). data is then empty.
needsPermissiontrue when the Facebook app lacks 'Page Public Content Access'.
Validate an Instagram location_id
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 } — the post's publish step is then the final check.
query Parameters
idNumeric Facebook Place ID to validate.
Validate an Instagram location_id › Responses
Validation result
valididnameaddressunverifiedCouldn't be checked now; the publish step will validate.
reasonWhy it isn't valid / couldn't be verified.