GET
$0.01 default
/api/discover/restaurantsDescription
Restaurant recommendations from the Blackbird network (~2,000 curated restaurants, mostly NYC and San Francisco). Full-text search plus city/neighborhood filters, with complete specials on every result, refreshed daily from a cache (never a live call) — e.g. every West Village restaurant with its current Fly-reward offers in one call.
Pricing
$0.01 default
Parameters
{
"properties": {
"city": {
"description": "Case-insensitive city filter, e.g. 'new york'",
"type": "string"
},
"fields": {
"description": "slim returns id/name/specials/specials_checked_at only (default limit 50, max 200) for a cheap wide sweep. full (default) returns locations, cuisine, price, and complete specials (default limit 20, max 100).",
"enum": [
"full",
"slim"
],
"type": "string"
},
"include_specials": {
"description": "Deprecated: accepted and ignored. Specials are always present now — use fields instead.",
"type": "boolean"
},
"limit": {
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"neighborhood": {
"description": "Case-insensitive neighborhood filter, e.g. 'west village'",
"type": "string"
},
"offset": {
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Full-text search over name, cuisine, city, neighborhood",
"type": "string"
}
},
"type": "object"
}Example response
{
"charge_id": "8e9a4a1a-0000-0000-0000-000000000000",
"limit": 5,
"offset": 0,
"restaurants": [
{
"cuisine": [
"Italian"
],
"id": "07fffaa3-eaab-43c5-8cba-61407f92b8c5",
"name": "Via Carota",
"neighborhoods": [
"west village"
],
"price": 3,
"specials": [
{
"fly_reward_bips": 1000,
"label": "Earn 10x Fly when you pay with Blackbird"
}
]
}
],
"synced_at": "2026-08-08T12:00:00Z",
"total": 40
}