GET/social-media/search-places

Search real-world places (restaurants, venues, hotels, landmarks) to geotag on Facebook and Instagram posts. The returned id works as both facebookPlaceId and instagramLocationId.

https://api.postfa.st/Auth: pf-api-keyRate limit: 90 requests per hour

One id, both platforms

The returned id is a Facebook Page ID with location data. Use the same value for facebookPlaceId when posting to Facebook and for instagramLocationId when posting to Instagram - resolve a place once and geotag it on either network.

Set the matching geotag via the controls object on POST /social-posts.

Coverage and caching

Only Pages that have address data are returned (you cannot get a non-place Page back), so narrow queries naturally return fewer results.

Results are cached for 7 days server-side, so repeated lookups of the same query are fast.

Query parameters

qstringrequired

Search text, minimum 2 characters (e.g. q=eiffel tower). Returns up to 100 matching places (Facebook's per-call maximum).

Response

200 OK Array of matching places. Store the id - it works as both facebookPlaceId and instagramLocationId.

idstringrequired

Numeric Facebook Page ID that carries location data. Use it as facebookPlaceId on Facebook and as instagramLocationId on Instagram.

namestringrequired

Place name.

citystringoptional

City, when the Page exposes it.

countrystringoptional

Country, when the Page exposes it.

streetstringoptional

Street address, when the Page exposes it.

zipstringoptional

Postal/ZIP code, when the Page exposes it.

pictureUrlstringoptional

Small thumbnail for the place, when available.