Resy Scraper – Restaurant Data & Availability

Scrape restaurant data from Resy. Search by name and city to get the full venue record — address, coordinates, phone, website, cuisine, price tier, ratings, photos, restaurant group, Google Place ID — then read every open table for a date and party size, or a day-by-day calendar of when a booked-out restaurant actually has something. Built for restaurant datasets, reservation monitoring, hospitality research and cancellation watching.

$1.00 per 1,000 results, with Apify platform usage included — no monthly fee, and nothing to pay for a run that legitimately finds nothing. A result is one restaurant, with every field below.

Unofficial. Not affiliated with, endorsed by, or sponsored by Resy.

Features

• Global venue search — across Resy's 2,000+ markets: US, Mexico, Spain, Italy, Japan, Canada and more.
• Full restaurant record — name, address, coordinates, phone, website, cuisine, price tier, rating and rating count, neighborhood, photos.
• Open tables for a date and party size — every seating time with its seating area, turn time and deposit rules.
• A booking calendar — every day in a window marked available, sold out or closed, so one run finds the openings at a restaurant booked for weeks.
• Google Place ID and Resy venue ID on every item — your list lines up with Resy's without fuzzy name matching.
• Restaurant groups mapped — each item names its hospitality group and lists the Resy IDs of every sibling restaurant.
• Two ways in — search by name and city, or read specific Resy venue URLs.
• Search radius control — radiusKm keeps results inside one city instead of ranking the whole country.
• Party size respected throughout — a table for two and a table for eight are different questions, and both availability and the calendar honour it.
• Empty means something — an empty dataset is a verdict ("not on Resy", "booked solid"), never a silent failure.

Input

Search by name. query plus city finds restaurants across Resy's 2,000+ markets — US, Mexico, Spain, Italy, Japan, Canada and more. Resy ranks matches across the country with your city first, so Carbone in Miami returns the Miami location, then New York, Dallas and Las Vegas. Set radiusKm to keep results inside one city.

{ "city": "Miami", "query": "Carbone", "maxItems": 5 }

Read specific venues. startUrls takes Resy venue URLs and reads each one directly. When it is set, the search inputs are ignored.

{ "startUrls": [{ "url": "https://resy.com/cities/new-york-ny/venues/carbone" }] }

Either way, add availability, the calendar, or both:

{
  "city": "New York",
  "query": "pizza",
  "maxItems": 10,
  "includeAvailability": true,
  "date": "2026-08-22",
  "partySize": 2,
  "includeCalendar": true,
  "calendarDays": 30
}

Output

One dataset item per restaurant. A plain venue read carries 79 fields; switching on availability and the calendar adds 15 more for 94 in total. Those 15 are left out rather than set to null when you do not ask for them, so slots or calendar being absent means you did not request that layer. Every field is listed below, so you can tell before running it whether the data you need is in here.

{
  "id": 6194,
  "name": "Carbone",
  "canonicalUrl": "https://resy.com/cities/new-york-ny/venues/carbone",
  "address": "181 Thompson Street",
  "crossStreet": "Bleecker Street",
  "neighborhood": "Greenwich Village",
  "locality": "New York",
  "region": "NY",
  "postalCode": "10012",
  "country": "United States",
  "latitude": 40.7279891,
  "longitude": -74.0002311,
  "timeZone": "EST5EDT",
  "phone": "+12122543000",
  "website": "http://carbonenewyork.com/",
  "menuUrl": "https://carbonenewyork.com/?menu=dinner",
  "googlePlaceId": "ChIJmSvG_ZFZwokRTOFeiLXzkmA",
  "foursquareId": "504b2a9ee4b006c435a465d3",
  "cuisine": ["Italian"],
  "priceRange": 4,
  "averageSpend": "$150",
  "rating": 4.74814,
  "ratingCount": 33328,
  "minPartySize": 1,
  "maxPartySize": 14,
  "images": ["https://image.resy.com/3/003/2/6194/eb7e05…/jpg/640x360"],
  "about": "Carbone is Chef Mario Carbone's homage to the great Italian American restaurants…",
  "whyWeLikeIt": "Carbone puts on the ritz of times gone by…",
  "needToKnow": "Reservations can be made up to 30 days in advance… a deposit of $50 per person…",
  "collections": ["Top Rated", "Global Dining Access"],
  "venueGroup": "Major Food Group",
  "venueGroupVenueIds": [6249, 7457, 8656, 10389],
  "socialLinks": [{ "name": "instagram", "value": "majorfoodgroup" }],
  "isGlobalDiningAccess": true,
  "isResyCreditEligible": true,
  "scrapedAt": "2026-08-19T02:43:16.478Z"
}

With includeAvailability, each item also carries its open tables:

{
  "availabilityDate": "2026-08-22",
  "partySize": 2,
  "slotCount": 24,
  "earliestSlot": "2026-08-22 16:00:00",
  "latestSlot": "2026-08-22 21:45:00",
  "slotTypes": ["Dining Room"],
  "slots": [
    {
      "startTime": "2026-08-22 16:00:00",
      "endTime": "2026-08-22 17:30:00",
      "type": "Dining Room",
      "turnTimeSeconds": 5400,
      "minSize": 1,
      "maxSize": 2,
      "quantity": 13,
      "isPaid": true,
      "cancellationFee": 10,
      "cancelCutOffTime": "15:00:00",
      "token": "rgs://resy/69262/3772090/2/2026-08-22/…"
    }
  ]
}

With includeCalendar, it carries the booking window:

{
  "calendarStart": "2026-08-19",
  "calendarEnd": "2026-09-18",
  "calendarLastBookableDate": "2026-12-25",
  "availableDates": ["2026-08-21", "2026-09-02"],
  "availableDateCount": 2,
  "calendar": [
    { "date": "2026-08-19", "reservation": "sold-out", "event": "not available", "walkIn": "available" },
    { "date": "2026-08-21", "reservation": "available", "event": "not available", "walkIn": "available" }
  ]
}

Set includeRaw to attach Resy's untouched JSON under raw when you need a detail that has no named field.

The dataset ships four views: Venues (one row per restaurant), Open tables (one row per bookable seating), Booking calendar (one row per day per restaurant) and Contact & identifiers.

Every field

Identity and links

Where it is

Matching it to your own records

Contact

Cuisine and price

Ratings

Party size

Photos

What the venue and Resy say about it

Restaurant group and socials

Programmes, policies and booking rules

Open tables — with includeAvailability

Booking calendar — with includeCalendar

Run metadata

How to use

From Apify Console

1. Open the Actor and click Try for free / Start.
2. Put the restaurant name into Search query and the city into City — or paste Resy venue URLs into Venue URLs to skip the search entirely.
3. Set Max items to how many venues you want back.
4. To check tables, switch on Include availability and set Date (YYYY-MM-DD) and Party size. The date is required — without it you get a single explanatory row instead of results.
5. To answer "when can I get in?", switch on Include booking calendar and set Calendar length (days).
6. Click Start, then open the Dataset tab and export as JSON, CSV or Excel.

From the API

curl -s "https://api.apify.com/v2/acts/simple.actors~resy-availability/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"city": "New York", "query": "Balthazar", "maxItems": 2}'

Swap the input for

{"startUrls": [{"url": "…"}], "includeAvailability": true, "date": "2026-08-25", "partySize": 2}

Watching a booked-out restaurant for cancellations, with the JavaScript client:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('simple.actors/resy-availability').call({
    startUrls: [{ url: 'https://resy.com/cities/new-york-ny/venues/carbone' }],
    includeAvailability: true,
    date: '2026-09-14',
    partySize: 2,
    keepUnavailable: true,     // keep the venue even at slotCount: 0
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
if (items[0]?.slotCount > 0) console.log('A table opened up:', items[0].slots);

Use cases

• Build a restaurant dataset — cuisine, price tier, rating and rating count, neighborhood, coordinates, phone, website and photos for every venue matching a name or a city.
• Find a table on a specific date for a specific party size, with the exact seating times, seating areas, turn times and deposit rules.
• Answer "when can I get in?" — the booking calendar marks every day in a window as available, sold out or closed, so one run finds the openings at a restaurant that is booked for weeks.
• Monitor availability — run it daily per venue and date to track how far ahead tables disappear, or to catch a cancellation.
• Enrich your own records — every item carries the Google Place ID and the Resy venue ID, so your list lines up with Resy's without fuzzy name matching.
• Map a restaurant group — each item names its hospitality group and lists the Resy IDs of every sibling restaurant.

Usage notes

Simple, transparent pay-per-result pricing — no subscriptions.

Availability semantics

By default, a restaurant with no open tables is left out of the results, so an availability run returns exactly what is bookable. Switch on keepUnavailable to keep every venue with slotCount: 0 instead — useful when you want the full list with a booked/not-booked flag.

Party size matters: a table for two and a table for eight are different questions, and both availability and the calendar are read for partySize.

What an empty result means

An empty dataset is an answer, not a failure. In search mode it means the restaurant is not on Resy; in availability mode it means nothing is bookable for that date and party size.

That holds because a broken lookup — a challenge page, a terminal 4xx, retries exhausted — fails the run rather than finishing with nothing. So you can trust emptiness, and treat a failed run as a retryable error. To tell "booked solid" from "left Resy", run the same URL without includeAvailability.

An input problem is a row, not a failed run. Asking for availability without a date cannot be answered, but it is not a broken lookup either — so the run finishes SUCCEEDED with a single row carrying error and errorDescription, and the same reason in its status message. That row is never charged. So before reading an empty-looking dataset as a verdict, check whether its only row has an error key.

Settings

• proxy — defaults to Apify datacenter proxy. If Resy starts blocking datacenter IPs, switch to {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}; the payloads are tiny JSON, so residential bandwidth cost stays negligible.
• radiusKm — restrict search results to one city instead of ranking the whole country.
• geo / locationSlug — anchor a search on exact coordinates when a city name is not enough.
• apiKeyFallback — last-known Resy public frontend key, used only if reading the current one fails.
• Runs are capped at 256 MB; platform usage is included in the per-result price.

The resy-shared key-value store

The actor reads Resy's public frontend API key off resy.com and caches it for 12 hours, along with Resy's city table, in a key-value store named resy-shared, so repeated runs don't re-fetch either. This store is created in your own account on first run — that's expected, and it holds nothing but that cache.

FAQ

Is scraping Resy legal? This Actor calls Resy's public frontend API — the same endpoints resy.com's own web client uses — without a licensing agreement. Check the platform's ToS and your own obligations before using it, and run it at a volume and rate you are comfortable defending.

Do I need a Resy account, login or API key? No. It reads Resy's public frontend key off resy.com itself and caches it, so there is nothing for you to supply.

Can it book a table for me? No. It reads what is bookable and returns the seating times, areas, turn times and deposit rules — it does not place reservations.

How do I find out when a fully booked restaurant has something? Switch on includeCalendar and set calendarDays. The calendar marks every day in the window as available, sold out or closed, so a single run finds the openings at a restaurant that is booked for weeks.

Why did my availability run return nothing? Most likely nothing is bookable for that date and party size — that is a real answer, and by default venues with no open tables are dropped. Set keepUnavailable: true to keep them with slotCount: 0. To tell "booked solid" from "left Resy", run the same URL without includeAvailability.

Does party size change the answer? Yes. A table for two and a table for eight are different questions, and both availability and the calendar are read for partySize.

Why does a resy-shared key-value store appear in my account? That is expected. Resy's public frontend key and its city table are cached there for 12 hours so repeated runs do not re-fetch either. It holds nothing else.

Can I search a specific city rather than the whole country? Yes — set radiusKm. By default Resy ranks matches nationally with your city first, so Carbone in Miami returns Miami, then New York, Dallas and Las Vegas.

Note

This actor is not affiliated with, endorsed by, or sponsored by Resy. It calls Resy's public frontend API — the same endpoints resy.com's own web client uses — without a licensing agreement. Review Resy's terms before using it, and run it at a volume and rate you are comfortable defending.