{"uid":"cap_hurwr8WoCp1uFHhvUYIQR","slug":"agentic-reservations-restaurant-search-resy-e67fd0c2","name":"Agentic Reservations – Restaurant Search (Resy)","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://www.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":0,"rating":{"score":"0.00","successRate":"0.80","reviews":0,"stars":null,"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_tbWvBbZUysGBezeKxlWBV","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":"Searches for restaurants by name on Resy, returning venue details like rating, cuisine, neighborhood, and venue ID for use in subsequent booking calls.","exampleAgentPrompt":"Can you search Resy for 'Carbone' so I can get its venue ID, rating, cuisine, and neighborhood before I book a table?","exampleUseCases":[{"title":"Find Italian restaurants in Greenwich Village","prompt":"I'm taking a client to dinner in Greenwich Village and want Italian food. Can you search Resy for some options and show me their ratings and venue IDs so I can pick one to book?"},{"title":"Look up restaurant details before booking","prompt":"My friend mentioned a place called Balthazar but I'm not sure of the exact spelling or if it's on Resy. Can you search for it and tell me what cuisine they serve and their neighborhood?"},{"title":"Verify restaurant info for confirmation","prompt":"I want to make sure I'm booking the right Carbone—can you search Resy and confirm the rating, cuisine type, and neighborhood before I finalize the reservation?"}],"resultDescription":"A JSON array of matching restaurants, each with fields: name (string), venue_id (integer), rating (number or null), cuisine (array of strings), and neighborhood (string). Used as input to downstream booking calls.","failureModes":["No results returned if the restaurant name doesn't match any Resy listing","Missing or null rating if the restaurant has no Resy ratings yet","Ambiguous results if the query matches multiple venues with similar names","HTTP 402 if payment/auth is not properly configured","Empty results array if Resy has no listings for the queried city or name"],"whenToPreferThis":"Use this endpoint when you need to resolve a restaurant name to a Resy venue_id before making a reservation, or when you want to surface cuisine type, neighborhood, and rating for a specific restaurant. Prefer this over generic web search when you specifically need Resy-native venue metadata for a subsequent booking workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":9,"lastUsedAt":"2026-07-13T15:04:52.683Z","lastSuccessfullyRanAt":"2026-07-13T15:04:52.683Z","lastHealthCheckAt":"2026-09-14T12:42:47.407Z","isFirstParty":false}