Skip to main content
GET
/
v1
/
place
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"

{
  "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": "https://seekeasy.ai/restaurant/tartine-bakery-guerrero",
  "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
Direct URL to place page on Seekeasy
​
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 --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"

{
  "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": "https://seekeasy.ai/restaurant/tartine-bakery-guerrero",
  "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"]
      }
    }
  ]
}