Search Resy restaurants near a position or by keyword. Each hit carries its id, name, cuisine, price band, rating, review count, full-size images and an availability object with slots. Filter by day, party size and a geo radius, and page through results. Omit day and party_size to use today and 2. Slot dates are ISO 8601 when a zone is known, otherwise naive venue-local. Costs 1 credit.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
7 optional filters available.
string
Required
Restaurant name, cuisine or keyword, 1 to 100 characters. Example: ramen.
ramen
string
Optional
Reservation date in YYYY-MM-DD form. Defaults to today.
2026-11-20
integer
Optional
Number of guests, 1 to 20. Defaults to 2 when day is omitted.
2
number
Optional
Latitude of the search centre. Send with longitude. Defaults to New York.
40.712941
number
Optional
Longitude of the search centre. Send with latitude.
-74.006393
integer
Optional
Search radius in metres, 100 to 50000.
10
integer
Optional
1-based page number. An out-of-range page returns zero hits.
1
string
Optional
IANA zone used to render slot dates as ISO 8601 when the hit has no venue zone. Without a zone the naive value is kept and date.time_basis is naive_venue_local. Slots after midnight may carry the next date; no slot is dropped.
example
Request Examples
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: YOUR_API_KEY_HERE"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
<?php
use Illuminate\Support\Facades\Http;
$response = Http::timeout(30)
->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
->get('https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393');
if ($response->successful()) {
echo $response->body();
} else {
echo "Error: " . $response->status();
}
const options = {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
};
fetch('https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393', options)
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.text();
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393',
headers: {
x-api-key: 'YOUR_API_KEY_HERE',
}
};
try {
const response = await axios(options);
console.log(response.data);
} catch (error) {
console.error('Error:', error.message);
}
require 'net/http'
require 'uri'
uri = URI.parse("https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'
begin
response = http.request(request)
puts response.body
rescue => e
puts "Error: #{e.message}"
end
import http.client
import json
conn = http.client.HTTPSConnection("scrappa.co")
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
conn.request("GET", "/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
except Exception as e:
print(f"Error: {e}")
finally:
conn.close()
import requests
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
response = requests.get('https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393', headers=headers)
response.raise_for_status()
print(response.text)
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class ApiExample {
public static void main(String[] args) {
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393")
.addHeader("x-api-key", "YOUR_API_KEY_HERE")
.build();
try (Response response = client.newCall(request).execute()) {
if (response.isSuccessful()) {
System.out.println(response.body().string());
} else {
System.out.println("Error: " + response.code());
}
} catch (IOException e) {
System.out.println("Error: " + e.getMessage());
}
}
}
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
client := &http.Client{}
req, err := http.NewRequest("GET", "https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393", nil)
if err != nil {
fmt.Println("Error creating request:", err)
return
}
req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error making request:", err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("Error reading response:", err)
return
}
fmt.Println(string(body))
}
#!/bin/bash
curl -X GET \
-H "x-api-key: YOUR_API_KEY_HERE" \
"https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393"
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");
try
{
var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
import axios from 'axios';
async function run(): Promise<void> {
try {
const response = await axios({
method: 'GET',
url: 'https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE',
},
});
console.log(response.data);
} catch (error) {
console.error('Error:', error);
}
}
void run();
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.get("https://scrappa.co/api/resy/search?query=ramen&day=2026-11-20&party_size=2&latitude=40.712941&longitude=-74.006393")
.header("x-api-key", "YOUR_API_KEY_HERE")
.send()
.await?;
println!("{}", response.text().await?);
Ok(())
}
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
success
data
meta
{
"success": true,
"data": {
"query": "ramen",
"search": {
"hits": [
{
"id": {
"resy": 60029
},
"name": "Le Gratin",
"price_range_id": 3,
"rating": {
"average": 4.6,
"count": 812
}
}
]
},
"pagination": {
"page": 1,
"per_page": 20,
"returned": 1
}
},
"meta": {
"endpoint_family": "search",
"billable": true
}
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Unsupported Filter
The request used a filter key that is not proven. No filter is fabricated. Not billable.
{
"message": "Unsupported filter: cuisine"
}Invalid Request
Resy rejected the request. Check the parameters. Not billable and not retryable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "VALIDATION",
"message": "The Resy request was rejected. Check the request parameters."
},
"success": false
}Venue Not Found
The requested venue was not found. Not billable.
{
"meta": {
"billable": false,
"endpoint_family": "venue"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested Resy venue was not found."
},
"success": false
}Invalid Source Response
The upstream response no longer matches the expected shape. Not billable.
{
"meta": {
"billable": false
},
"error": {
"code": "PARSER_DRIFT",
"message": "The Resy API is temporarily unavailable. Please retry."
},
"success": false
}Upstream Unavailable
No healthy egress or the upstream failed. Not billable.
{
"meta": {
"billable": false
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Resy API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.