---
title: "Search OpenTable restaurants near a location"
method: GET
path: "/opentable/search"
tags: ["OpenTable"]
---

# Search OpenTable restaurants near a location

`GET /opentable/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/opentable/search`
- Auth: API key in header `x-api-key`

Searches restaurants by free-text term (cuisine, name, neighborhood) near a latitude/longitude, for a given date/time and party size, including inline live availability per result.

## Query parameters

- `term` string, required
- `latitude` number, required
- `longitude` number, required
- `date_time` string
- `party_size` integer
- `size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- OpentableSearchResponseDoc
  - `code` integer
  - `data` OpentableSearchResponse
    - `results` OpentableSearchResult[]
      - `availability_date_time` string: AvailabilityDateTime/Timeslots mirror RestaurantResponse's inline availability -- search returns the same nested shape per result.
      - `city` string
      - `country` string
      - `description` string
      - `id` string
      - `latitude` number
      - `line1` string
      - `line2` string
      - `longitude` number
      - `name` string
      - `postal_code` string
      - `state` string
      - `timeslots` OpentableTimeslot[]
        - `available` boolean
        - `date_time` string
        - `points` integer
        - `price_amount` integer
        - `redemption_tier` string
        - `token` string: Token is the upstream booking token for this slot. It is opaque and only meaningful back to OpenTable's own booking flow -- this service does not implement booking, only discovery.
        - `type` string
    - `term` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)