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 "X-Seekeasy-Key: YOUR_API_KEY"

200

{
  "place_id": "sf_mission_001:Tartine Bakery",
  "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"]
      }
    }
  ]
}

X-Seekeasy-Key · string

Your Seekeasy API key for authentication.

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.

Response Fields

place_id · string

Unique identifier in format cell_id:restaurant_name

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 "X-Seekeasy-Key: YOUR_API_KEY"

200

{
  "place_id": "sf_mission_001:Tartine Bakery",
  "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"]
      }
    }
  ]
}