{"uid":"cap_6uNztd_yhXYD78DmR2sIJ","slug":"aisa-mpp-data-apis-brave-suggest-search-via-aisa-51d11d70","name":"Brave Suggest Search via AIsa","description":"<!-- aisa-pricing:start -->\nPublished reference price: $0.0005 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/brave/suggest/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","title":"The user's suggest search query term.","maxLength":400,"minLength":1,"description":"The user’s suggest search query term. Query can not be empty. The max query length is 400 characters, and the word limit is 50 words."},"lang":{"allOf":[{"enum":["ar","eu","bn","bg","ca","zh-hans","zh-hant","hr","cs","da","nl","en","en-gb","et","fi","fr","gl","de","el","gu","he","hi","hu","is","it","ja","jp","kn","ko","lv","lt","ms","ml","mr","nb","pl","pt-br","pt-pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi"],"type":"string","title":"Language"},{"default":"en"}],"description":"The suggest search language preference, where potentially the results could come from. The 2 or more character language code for which the suggest search results are provided. This is a just a hint for calculating suggest responses."},"rich":{"type":"boolean","title":"Rich","default":false,"description":"Whether to enhance suggestions with rich results. This requires a paid autosuggest subscription."},"count":{"type":"integer","title":"Count","default":5,"maximum":20,"minimum":1,"description":"The number of suggestion search results returned in response. The actual number of results delivered may be less than requested. Minimum is 1, maximum is 20. The default is 5."},"country":{"allOf":[{"enum":["AR","AU","AT","BE","BR","CA","CL","DK","FI","FR","DE","GR","HK","IN","ID","IT","JP","KR","MY","MX","NL","NZ","NO","CN","PL","PT","PH","RU","SA","ZA","ES","SE","CH","TW","TR","GB","US","ALL"],"type":"string","title":"SearchCountry"},{"default":"US"}],"description":"The suggest search query country, where potentially the results could come from. The country string is limited to 2 character country codes of supported countries. This is a just a hint for calculating suggest responses."}}},"responseSchema":{"type":"object","title":"SuggestSearchApiResponse","required":["query"],"properties":{"type":{"enum":["suggest"],"type":"string","const":"suggest","title":"Type","default":"suggest"},"query":{"type":"object","title":"OriginalQuery","required":["original"],"properties":{"original":{"type":"string","title":"Original","description":"The original query that was requested."}}},"results":{"type":"array","items":{"type":"object","title":"SuggestResult","required":["query"],"properties":{"img":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img","description":"The suggested query enriched image URL."},"type":{"anyOf":[{"enum":["query","entity","calculator"],"type":"string","title":"SuggestType","description":"<p>Kind tag on a rich suggestion entry.</p>\n<p>Open set: mixer emits these today, but we may add Rich Header verticals\nover time, so consumers must render an unrecognised value as plain text.</p>"},{"type":"null"}],"description":"Kind of suggestion, currently <code>query</code> or <code>entity</code>. New kinds may be added, so treat an unrecognised value as a plain query suggestion."},"query":{"type":"string","title":"Query","description":"Suggested query completion."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The suggested query enriched title."},"is_entity":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Entity","description":"Whether the suggested enriched query is an entity. Deprecated: use <code>type</code> instead."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The suggested query enriched description."}}},"title":"Results","default":[],"description":"The list of suggestions for the given query."}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.0005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.0005/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.0005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.0005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2Iu3YEf9q62mCN54n8D3Z","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.0005","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Returns autocomplete/typeahead query suggestions for a partial search term using Brave's suggestion engine","exampleAgentPrompt":"Can you give me up to 10 Brave search suggestions for 'climate change solut' in English for the US, so I can autocomplete the user's query?","exampleUseCases":[{"title":"Typeahead for search interface","prompt":"I'm building a search box and need autocomplete suggestions — give me the top 8 Brave suggestions for 'best electric car' in English for the US market."},{"title":"Query expansion for research agent","prompt":"I want to discover popular related searches around 'machine learning frameworks' — can you fetch 10 Brave query suggestions for that term?"},{"title":"Multilingual search suggestions","prompt":"Get me 5 Brave search suggestions for 'recettes de pâtes' in French for France, so I can populate the suggestion dropdown in our French-language app."}],"resultDescription":"Returns a JSON object containing the original query and an array of suggested query completions. Each suggestion includes the completed query string, a type tag (query, entity, or calculator), and optionally enriched metadata like a title, description, and image URL when rich mode is enabled.","failureModes":["Empty query string returns a 422 validation error — q is required and must be at least 1 character","Query exceeding 400 characters or 50 words returns a validation error","Unsupported language or country code returns a validation error","Rich results requested without an active paid autosuggest subscription returns limited or no enriched data","Fewer results than requested count may be returned if Brave has insufficient suggestions for the query","Network or upstream Brave Search service outage returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need real-time autocomplete or typeahead query suggestions powered by Brave Search, especially when you want to avoid Google/Bing dependence. It is ideal for populating search suggestion dropdowns, expanding partial user queries, or discovering popular related search terms. At $0.0005/call it is cost-effective for high-frequency typeahead scenarios. Prefer this over full-text search endpoints when you only need completions, not full search result pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:55:45.367Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-brave-suggest-search-via-aisa-51d11d70"}