Place Lookup

GET /v1/place - Look up place details with social content

GET /v1/place

cURL

curl --request GET \
  --url "https://api.seekeasy.ai/v1/place?place_name=Tartine%20Bakery&place_lat=37.7614&place_lon=-122.4241" \
  --header "Authorization: Bearer YOUR_API_KEY"

200

{
  "place_id": "8a283082c2dffff:Tartine Bakery",
  "slate_id": "b1f0c2d4-9e3a-4c17-8f2b-5a6d7e8f9012",
  "place_name": "Tartine Bakery",
  "address": "600 Guerrero St, San Francisco, CA 94110",
  "tagline": "Iconic bakery known for morning buns and country bread",
  "highlights": [
    "Famous morning buns",
    "Country sourdough",
    "Great coffee",
    "Instagram-worthy"
  ],
  "coordinates": {
    "lat": 37.7614,
    "lon": -122.4241
  },
  "seekeasy_url": null,
  "is_trending": true,
  "is_creator_fav": true,
  "posts": [
    {
      "post_id": "post_xyz789",
      "media": [
        {
          "image_url": "https://cdn.seekeasy.ai/media/posts/post_xyz789_cover600x744.jpg",
          "is_video": false
        }
      ],
      "caption": "The morning bun at Tartine is unreal",
      "source_type": "instagram",
      "profile": {
        "instagram_username": "sf_foodie_anna",
        "instagram_follower_count": 45200,
        "taste_profile": ["bakeries", "brunch spots"]
      }
    }
  ]
}

Authorization · string · required

Bearer <your API key>. The X-Seekeasy-Key header still works, but is deprecated — responses to it carry a Warning header.

X-Seekeasy-Session-Id · string

Optional. The same session_id you send on events. Supplying it lets us tell a session that saw content and passed on it from one that never scrolled to it — a distinction that is otherwise invisible, because a set of posts that draws no events has nothing tying it to a session.

place_name · string

Name of place to search. Use with place_lat/place_lon for better accuracy.

external_id · string

Partner internal place ID. For known partners, maps to your platform restaurant ID. Use instead of place_name for partner integrations.

place_lat · number

Latitude to bias search results toward a specific location.

place_lon · number

Longitude to bias search results toward a specific location.

Either place_name or external_id must be provided. When using place_name, providing coordinates significantly improves match accuracy.

Call this once per set of posts you display, and don’t cache the response across users. Each response carries a fresh slate_id identifying the exact posts we served, in order. Reusing one response for several viewers makes their engagement indistinguishable, which understates how often content was shown and corrupts the analytics you get back. The signed media URLs also expire one hour after the call.

Response Fields

place_id · string

Unique identifier in format cell_id:restaurant_name

slate_id · string

Identifier for the set of posts returned by this call. Echo it back on every event so engagement can be tied to the posts we served and the order we served them in. A new one is minted per call.

place_name · string

Name of the place

address · string

Full address

tagline · string

AI-generated descriptive tagline

highlights · array

Key features of the place

coordinates · object

Location coordinates with lat and lon fields

seekeasy_url · string | null

Direct URL to the place page on Seekeasy. Currently always null — retained for backward compatibility while Seekeasy place pages are unavailable.

is_trending · boolean

Whether the place is currently trending based on creator activity

is_creator_fav · boolean

Whether marked as a creator favorite

posts · array

Social posts with media and creator profiles

cURL

curl --request GET \
  --url "https://api.seekeasy.ai/v1/place?place_name=Tartine%20Bakery&place_lat=37.7614&place_lon=-122.4241" \
  --header "Authorization: Bearer YOUR_API_KEY"

200

{
  "place_id": "8a283082c2dffff:Tartine Bakery",
  "slate_id": "b1f0c2d4-9e3a-4c17-8f2b-5a6d7e8f9012",
  "place_name": "Tartine Bakery",
  "address": "600 Guerrero St, San Francisco, CA 94110",
  "tagline": "Iconic bakery known for morning buns and country bread",
  "highlights": [
    "Famous morning buns",
    "Country sourdough",
    "Great coffee",
    "Instagram-worthy"
  ],
  "coordinates": {
    "lat": 37.7614,
    "lon": -122.4241
  },
  "seekeasy_url": null,
  "is_trending": true,
  "is_creator_fav": true,
  "posts": [
    {
      "post_id": "post_xyz789",
      "media": [
        {
          "image_url": "https://cdn.seekeasy.ai/media/posts/post_xyz789_cover600x744.jpg",
          "is_video": false
        }
      ],
      "caption": "The morning bun at Tartine is unreal",
      "source_type": "instagram",
      "profile": {
        "instagram_username": "sf_foodie_anna",
        "instagram_follower_count": 45200,
        "taste_profile": ["bakeries", "brunch spots"]
      }
    }
  ]
}