Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaMaps & ReviewsAvailable now

Resy · Search venues

resy-com/restaurants/search_venues

Get places and reviews from maps with Resy · Search venues from Alexandria through one Spiral API key. Discovery: find restaurants near a point (optionally by name or cuisine keyword) that have a table on a day. Follow with venue, availability or slot_conditions using venue_id and config_token. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
day requiredtext—

Calendar day: YYYY-MM-DD, today, tomorrow or +N days from today. Relative days resolve on the UTC calendar. Pattern: ^([0-9]{4}-[0-9]{2}-[0-9]{2}|today|tomorrow|\+[0-9]{1,3})$.

latitude requirednumber
-90 to 90
—

latitude

longitude requirednumber
-180 to 180
—

longitude

pagenumber
1 to 1000
—

1-based page; pass next_page from the previous result.

querytext—

Free text (name, cuisine); empty or omitted browses every venue in the radius.

per_pagenumber
1 to 50
—

Hits per page (default 20).

radius_mnumber
500 to 161000
—

Search radius as the site takes it (default 16100, the web client's 10 miles).

party_sizenumber
1 to 20
—

Number of guests (default 2).

time_filtertext—

Preferred time HH:MM (24h, venue-local); the site returns slots around it. Pattern: ^([01][0-9]|2[0-3]):[0-5][0-9]$.

include_tock_inventorytrue or false—

Include the Tock-hosted venues the site merges into search, as the web client does (default true); pass false for Resy-native venues only. Tock rows are flagged is_tock_inventory and are the only inventory in markets Resy itself does not serve.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "resy-com/restaurants/search_venues",
    "input": {
      "day": "<day>",
      "latitude": -90,
      "longitude": -180
    }
  }'

Frequently asked questions

How much does Resy · Search venues cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Resy · Search venues through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "resy-com/restaurants/search_venues"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Resy · Search venues?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Resy · Search venues?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.