{"uid":"cap_buVSpz5pANQmD0jn6rw7G","slug":"blackbird-restaurant-discovery-via-agentic-reservations-841980c1","name":"Blackbird Restaurant Discovery via Agentic Reservations","description":"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.","url":"https://agentres.dev/api/discover/restaurants?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"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}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qzs4N_saWvDk76nWWgwcn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches and filters ~2,000 curated Blackbird-network restaurants (primarily NYC and San Francisco) with optional live Fly-reward specials per result","exampleAgentPrompt":"Can you find me Blackbird-network restaurants in the West Village that have active Fly-reward specials right now? Show me up to 20 results.","exampleUseCases":[{"title":"Date night spot with live specials","prompt":"Find me romantic restaurants in the West Village on the Blackbird network — I want to see whatever Fly-reward specials they have going on right now, up to 10 results."},{"title":"Exploring SF dining by neighborhood","prompt":"Show me up to 20 curated Blackbird restaurants in San Francisco's Mission district — just the basic listings, no need for specials."},{"title":"Cuisine search across NYC","prompt":"Search the Blackbird network for Japanese restaurants in New York City and include any live specials they're currently offering, limit to 15 results."}],"resultDescription":"A paginated JSON array of restaurant objects including id, name, cuisine types, price tier (1–4), image URL, website URL, cities, neighborhoods, and location details (address, coordinates, time zone). When include_specials is true, each restaurant also carries its current Fly-reward offers (empty array means no active offers; null means the live lookup failed). The response envelope includes total count, limit, offset, sync timestamp, and a charge ID UUID for the payment transaction.","failureModes":["Query matches no restaurants — returns empty restaurants array with total: 0","include_specials live lookup fails for individual restaurants — specials field returns null for affected entries","limit exceeds 20 when include_specials is true — API caps results at 20 automatically","Payment not processed or x402 auth missing — request rejected before execution","City or neighborhood string doesn't match any known value — returns empty results silently","offset beyond total count — returns empty page"],"whenToPreferThis":"Choose this endpoint when you need to discover or search Blackbird-network restaurants specifically, especially when the user cares about Fly loyalty rewards or live specials. It is not a general restaurant search (e.g. Yelp or Google Maps); its value is the curated Blackbird network and the ability to surface real-time reward offers in a single call. Prefer it over booking endpoints when the user is still in the discovery/browsing phase rather than ready to reserve a table.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:41:40.762Z","isFirstParty":false,"canonicalSlug":"blackbird-restaurant-discovery-via-agentic-reservations-841980c1"}