Skip to content
onelayer.
All tools

Tool detail

Agentic Reservations

Searches roughly 2,000 curated Blackbird-network restaurants, mostly in NYC and San Francisco, by keyword, city or neighborhood, returning current specials on each result.

Categories: Travel booking, Maps places

Use when

  • find restaurants in a neighborhood with current specials
  • search restaurants by cuisine or name in a city
  • get a cheap wide sweep of restaurant ids and specials
  • look up every restaurant's reward offers in an area

Not for

  • not for booking a table - discovery/search only
  • not for cities outside the Blackbird network (mostly NYC/SF)
  • not live - specials are cached and refreshed daily

Inputs

GET query params: query, city, neighborhood (strings, optional filters); fields=full|slim (optional), limit/offset (integers, optional); include_specials deprecated

Admitted input schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Case-insensitive city filter, e.g. 'new york'"
    },
    "fields": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "full",
        "slim"
      ],
      "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)."
    },
    "include_specials": {
      "type": "boolean",
      "description": "Deprecated: accepted and ignored. Specials are always present now — use fields instead."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "neighborhood": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Case-insensitive neighborhood filter, e.g. 'west village'"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "query": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Full-text search over name, cuisine, city, neighborhood"
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://agentres.dev/api/discover/restaurants

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://agentres.dev/api/discover/restaurants
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z