> ## Documentation Index
> Fetch the complete documentation index at: https://seekeasy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Place Lookup

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

<ParamField header="X-Seekeasy-Key" type="string">
  Your Seekeasy API key for authentication.
</ParamField>

<ParamField query="place_name" type="string">
  Name of place to search. Use with place\_lat/place\_lon for better accuracy.
</ParamField>

<ParamField query="external_id" type="string">
  Partner internal place ID. For known partners, maps to your platform restaurant ID. Use instead of `place_name` for partner integrations.
</ParamField>

<ParamField query="place_lat" type="number">
  Latitude to bias search results toward a specific location.
</ParamField>

<ParamField query="place_lon" type="number">
  Longitude to bias search results toward a specific location.
</ParamField>

<Note>
  Either `place_name` or `external_id` must be provided. When using `place_name`, providing coordinates significantly improves match accuracy.
</Note>

## Response Fields

<ResponseField name="place_id" type="string">
  Unique identifier in format `cell_id:restaurant_name`
</ResponseField>

<ResponseField name="place_name" type="string">
  Name of the place
</ResponseField>

<ResponseField name="address" type="string">
  Full address
</ResponseField>

<ResponseField name="tagline" type="string">
  AI-generated descriptive tagline
</ResponseField>

<ResponseField name="highlights" type="array">
  Key features of the place
</ResponseField>

<ResponseField name="coordinates" type="object">
  Location coordinates with `lat` and `lon` fields
</ResponseField>

<ResponseField name="seekeasy_url" type="string | null">
  Direct URL to the place page on Seekeasy. Currently always `null` — retained for backward compatibility while Seekeasy place pages are unavailable.
</ResponseField>

<ResponseField name="is_trending" type="boolean">
  Whether the place is currently trending based on creator activity
</ResponseField>

<ResponseField name="is_creator_fav" type="boolean">
  Whether marked as a creator favorite
</ResponseField>

<ResponseField name="posts" type="array">
  Social posts with media and creator profiles
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.seekeasy.ai/v1/place",
      params={
          "place_name": "Tartine Bakery",
          "place_lat": 37.7614,
          "place_lon": -122.4241
      },
      headers={"X-Seekeasy-Key": "YOUR_API_KEY"}
  )
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.seekeasy.ai/v1/place?place_name=Tartine%20Bakery&place_lat=37.7614&place_lon=-122.4241",
    {
      headers: { "X-Seekeasy-Key": "YOUR_API_KEY" }
    }
  );
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"]
        }
      }
    ]
  }
  ```

  ```json 404 theme={null}
  {
    "detail": "Place not found"
  }
  ```

  ```json 403 theme={null}
  {
    "detail": "Invalid API key"
  }
  ```
</ResponseExample>