{"uid":"cap_tFW0HamiOCWLLDe0-h_GF","slug":"brave-search-local-descriptions-3e1f0b31","name":"Brave Search Local Descriptions","description":"AI-generated descriptions of places found by web or place search. Use it to learn what a place is before recommending it. Pass the location ids, repeated as ids=a&ids=b. Ids expire after about 8 hours.","url":"https://search.agent.s.brave.app/res/v1/local/descriptions?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","required":["ids"],"properties":{"ids":{"type":"array","items":{"type":"string"},"maxItems":20,"minItems":1,"description":"Location ids from web or place search, valid for 8 hours. Repeat as ids=a&ids=b"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SgpmDcZr2ctvEscsPEy9y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns AI-generated descriptions of places identified by location IDs from a previous Brave web or place search.","exampleAgentPrompt":"I just searched for coffee shops near downtown Seattle — can you pull up the AI-generated descriptions for those locations so I know what each place is like before I recommend one?","exampleUseCases":[{"title":"Restaurant recommendation with context","prompt":"I found a few Italian restaurants using Brave place search — can you fetch the descriptions for those location IDs so I can tell my user what each place is actually like before picking one?"},{"title":"Tourist attraction briefing","prompt":"Before I recommend these three museums to my user, can you get me the Brave descriptions for their location IDs so I can give a quick summary of what each one is?"},{"title":"Business vetting before referral","prompt":"I have location IDs for two co-working spaces I found in a search — can you pull their AI-generated descriptions so I can decide which one is worth recommending?"}],"resultDescription":"An array of objects, each containing the location ID, a type label, and an AI-generated text description of the place — suitable for presenting to a user or feeding into a recommendation.","failureModes":["Expired location IDs (older than ~8 hours) return no results or an error — IDs must be fresh from a recent search","Invalid or malformed IDs return empty results","Requesting more than 20 IDs at once is rejected","IDs from non-Brave sources are not recognized","Network or service errors return HTTP error codes"],"whenToPreferThis":"Use this endpoint when you already have location IDs from a Brave web or place search and need human-readable, AI-generated descriptions of those places before recommending or presenting them. It is the right choice when you want to add context or narrative to raw place results without doing a full web scrape. Prefer it over the place details endpoint when you need descriptive text rather than structured data like hours or phone numbers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:32:19.332Z","isFirstParty":false,"canonicalSlug":"brave-search-local-descriptions-3e1f0b31"}