API reference
Locations
Place metadata and the media posted there.
Location ids come from GET /search/places, or from the
location field on any post.
Location info
Name, category, address, coordinates, and the linked business account where there is one.
What comes back
{
"name": "Blue Bottle Coffee",
"category": "Coffee Shop",
"phone": "+15551234567",
"website": "https://bluebottlecoffee.com",
"price_range": "$$",
"location_address": "1 Ferry Building",
"location_city": "San Francisco",
"location_zip": "94111",
"location_region": "CA",
"hours": {}
}Business fields are only populated where the place is a claimed business
account; a plain geotag returns name and little else.
Top and recent
Media posted at the location, ranked and chronological. Both use the standard
cursor and return media objects identical in
shape to /posts/{id}.
Path Parameters
location_id*Location Id
Query Parameters
cursor?|
Opaque pagination cursor from a previous next_cursor
curl -X GET "https://example.com/locations/string/top"{}{}Path Parameters
location_id*Location Id
Query Parameters
cursor?|
Opaque pagination cursor from a previous next_cursor
curl -X GET "https://example.com/locations/string/recent"{}{}What comes back
The standard list envelope, with media objects in the same shape as a post.
Errors
| Code | When |
|---|---|
not_found | No such location id. |
invalid_cursor | The cursor was not one we issued. |
upstream_error | Transient. Retry. |