{"uid":"cap_Bzhezr3xzmAZ85wPJttfm","slug":"agentres-restaurant-search-d510871c","name":"AgentRes Restaurant Search","description":"API that lets AI agents search and book restaurant reservations on Resy. Pay $0.01 USDC per booking with a crypto wallet.","url":"https://agentres.dev/api/search","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","required":["query"],"properties":{"query":{"type":"string","description":"Restaurant name to search for"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"rating":{"type":"number","nullable":true},"cuisine":{"type":"array","items":{"type":"string"}},"venue_id":{"type":"integer"},"neighborhood":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"results":[{"name":"Carbone","rating":4.7,"cuisine":["Italian"],"venue_id":6194,"neighborhood":"Greenwich Village"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":5,"rating":{"score":"0.92","successRate":"0.90","reviews":5,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_Qt2eXYypjedtaiUOIHnrS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search the AgentRes restaurant database by name and return matching results with ratings, cuisine types, and neighborhood info.","exampleAgentPrompt":"Search AgentRes for 'Carbone' — I want to see its rating, cuisine type, neighborhood, and venue ID before I try to book a table.","exampleUseCases":[{"title":"Find upscale Italian restaurant details","prompt":"Look up 'Balthazar' on AgentRes and tell me its rating, what cuisines they serve, and which neighborhood it's in so I can decide if I want to book there."},{"title":"Verify restaurant exists before booking","prompt":"Search AgentRes for 'Eleven Madison Park' and get me the venue ID and neighborhood — I want to make sure it's actually available to book through the system first."},{"title":"Confirm cuisine and location match","prompt":"Find 'Gramercy Tavern' in the AgentRes database and show me the rating and cuisine types so I know if it fits what my guests are looking for."}],"resultDescription":"Returns an array of matching restaurant objects, each containing the restaurant name, venue_id (integer), rating (number or null), cuisine (array of strings), and neighborhood (string). Multiple results may be returned if several venues match the query.","failureModes":["No results returned if the restaurant name is misspelled or not listed on AgentRes","Empty results array if the query matches no known venues","Missing or null rating field if the restaurant has no ratings data","HTTP 402 if payment is required (x402 protocol)","HTTP 400 if the required query parameter is missing"],"whenToPreferThis":"Use this endpoint when you need to look up a restaurant by name on AgentRes before booking — especially to retrieve the venue_id or confirm cuisine/neighborhood details needed for a subsequent reservation call. Prefer this over general web search when you need structured AgentRes-specific venue data like venue_id.","instructions":null,"reviewSummary":"Delivers fast, well-structured restaurant search results with stable venue IDs, cuisine, neighborhood, and ratings data — typically in around 2 seconds. Schema normalizes cleanly for downstream use, though venue photos are not included. Coverage appears limited to NYC; queries for venues in other cities return irrelevant NYC results, making it unreliable for multi-city use cases.","reviewSummaryHighlights":["Fast search responses (~2 seconds) with stable venue IDs","Clean, normalized schema with cuisine, neighborhood, and ratings data","Consistent accuracy and reliability for NYC venue discovery"],"reviewSummaryConcerns":["Search index appears hardcoded to NYC — non-NYC venues cannot be found","No venue photos returned in results"],"reviewSummaryGeneratedAt":"2026-07-28T06:16:13.988Z","activationCount":106,"lastUsedAt":"2026-07-28T02:25:39.171Z","lastSuccessfullyRanAt":"2026-07-28T02:25:39.171Z","lastHealthCheckAt":"2026-09-14T18:44:02.395Z","isFirstParty":false}