Agentic Reservations
GET agentres.dev/api/discover/restaurants
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
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.
Resource: agentres.dev/api/discover/restaurants
Network: eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x66717045858d9f598e2ebd046bf42a0b1063c0fa
Payment methods: — · Last validation: 2026-09-14 12:10:31.957+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "Case-insensitive city filter, e.g. 'new york'"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"query": {
"type": "string",
"description": "Full-text search over name, cuisine, city, neighborhood"
},
"fields": {
"enum": [
"full",
"slim"
],
"type": "string",
"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)."
},
"offset": {
"type": "integer",
"minimum": 0
},
"neighborhood": {
"type": "string",
"description": "Case-insensitive neighborhood filter, e.g. 'west village'"
},
"include_specials": {
"type": "boolean",
"description": "Deprecated: accepted and ignored. Specials are always present now — use fields instead."
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"limit": {
"type": "integer"
},
"total": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"charge_id": {
"type": "string",
"format": "uuid"
},
"synced_at": {
"type": "string",
"format": "date-time",
"nullable": true
},
"restaurants": {
"type": "array",
"items": {
"type": "object",
"description": "id, name, cuisine[], price tier (1-4), image_url, website_url, cities[], neighborhoods[], locations[] (address, coordinates, time_zone), specials ([] = checked, no offers; null = never checked), specials_checked_at",
"additionalProperties": true
}
}
}
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x66717045858d9f598e2ebd046bf42a0b1063c0fa",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 3600
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x66717045858d9f598e2ebd046bf42a0b1063c0fa",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "10000"
},
{
"raw": {
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"
},
"payTo": "FCFgb8Z63uwim2QpDJW4TGwLqZoENjckwGosLmg26zBS",
"amount": "10000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 3600
},
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"payTo": "FCFgb8Z63uwim2QpDJW4TGwLqZoENjckwGosLmg26zBS",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"amountAtomic": "10000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.