{"uid":"cap_JrkozqWztO4lKX-xD7i00","slug":"aisa-mpp-data-apis-aisa-brave-llm-context-0b7c816e","name":"AIsa Brave LLM Context","description":"<!-- aisa-pricing:start -->\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/brave/llm/context?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","title":"Q","maxLength":600,"minLength":1,"description":"The user’s search query term. Query can not be empty. Maximum of 600 characters and 75 words in the query."},"count":{"type":"integer","title":"Count","default":20,"maximum":50,"minimum":1,"description":"The maximum number of search results considered to select the LLM context data. The default is 20 and the maximum is 50."},"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 search query country, where the results come from. The country string is limited to 2 character country codes of supported countries."},"goggles":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Goggles","description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the <a href=\"/documentation/resources/goggles\">Goggles documentation</a>. The parameter can be a single Goggle or a list of up to 3 Goggles."},"freshness":{"type":"string","title":"Freshness","default":"","examples":["","pm","2022-04-01to2022-07-30"],"description":"<p>Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported:</p>\n<ul>\n<li><strong>pd</strong> - Pages aged 24 hours or less.</li>\n<li><strong>pw</strong> - Pages aged 7 days or less.</li>\n<li><strong>pm</strong> - Pages aged 31 days or less.</li>\n<li><strong>py</strong> - Pages aged 365 days or less.</li>\n<li><strong>YYYY-MM-DDtoYYYY-MM-DD</strong> - A custom date range is also supported by specifying start and end dates e.g. <code>2022-04-01to2022-07-30</code>.</li>\n</ul>"},"safesearch":{"anyOf":[{"enum":["off","moderate","strict"],"type":"string","title":"SafeSearch"},{"type":"null"}],"title":"Safe search","description":"<p>Filters results for adult content. The following values are supported:</p>\n<ul>\n<li><strong>off</strong> - No filtering is done.</li>\n<li><strong>moderate</strong> - Drops adult content from the results used for context.</li>\n<li><strong>strict</strong> - Drops all adult content from the results used for context.</li>\n</ul>\n<p>When not set, no filtering is applied — except for local recall, which stays <code>strict</code>.</p>"},"spellcheck":{"type":"boolean","title":"Spellcheck","default":true,"description":"Whether to enable spellcheck on the query."},"search_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 search language preference. The 2 or more character language code for which the search results are provided."},"enable_local":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enable Local","description":"Whether to enable local recall. Not setting this value means auto-detect: local recall is used if a location is provided (<code>X-Loc-Lat</code> with <code>X-Loc-Long</code>, or <code>X-Loc-City</code>)."},"context_threshold_mode":{"anyOf":[{"enum":["disabled","strict","lenient","balanced"],"type":"string","title":"SummarizerContextThresholdMode"},{"type":"null"}],"title":"Context Threshold Mode","description":"The mode to use to determine the threshold for including content in context."},"enable_source_metadata":{"type":"boolean","title":"Enable Source Metadata","default":false,"description":"Enable source metadata enrichment (site_name, favicon, thumbnail, description, fetched_content_timestamp) in the sources attribute of the response."},"maximum_number_of_urls":{"type":"integer","title":"Maximum Number Of Urls","default":20,"maximum":50,"minimum":1,"description":"Maximum number of different URLs to include in LLM context."},"maximum_number_of_tokens":{"type":"integer","title":"Maximum Number Of Tokens","default":8192,"maximum":32768,"minimum":1024,"description":"Approximate maximum number of tokens to include in context. The default is <code>8192</code> and maximum is <code>32768</code>."},"maximum_number_of_snippets":{"type":"integer","title":"Maximum Number Of Snippets","default":50,"maximum":256,"minimum":1,"description":"Maximum number of different snippets (or chunks of text) to include in LLM context. The default is <code>50</code> and maximum is <code>256</code>."},"maximum_number_of_tokens_per_url":{"type":"integer","title":"Maximum Number Of Tokens Per Url","default":4096,"maximum":8192,"minimum":512,"description":"Maximum number of tokens to include per URL. The default is <code>4096</code> and maximum is <code>8192</code>."},"maximum_number_of_snippets_per_url":{"type":"integer","title":"Maximum Number Of Snippets Per Url","default":50,"maximum":100,"minimum":1,"description":"Maximum number of snippets to include per URL. The default is <code>50</code> and maximum is <code>100</code>."}}},"responseSchema":{"type":"object","title":"LLMContextAPIResponse","properties":{"sources":{"type":"object","title":"Sources","default":{},"description":"Metadata for all referenced URLs, keyed by URL.","additionalProperties":{"type":"object","title":"Source","properties":{"age":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Age","description":"The page’s date rendered four ways, in fixed positions: full date, <code>YYYY-MM-DD</code>, relative age, and an ISO 8601 timestamp. Empty when the page has no known date."},"title":{"type":"string","title":"Title","default":"","description":"The page title."},"favicon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Favicon","description":"URL to the site’s favicon image."},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","description":"The most query-relevant passage of the source page."},"hostname":{"type":"string","title":"Hostname","default":"","description":"The source hostname."},"site_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Name","description":"The site name (e.g. ‘Wikipedia’)."},"thumbnail":{"anyOf":[{"type":"object","title":"Thumbnail","required":["src"],"properties":{"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt","description":"The alt text for the thumbnail image."},"src":{"type":"string","title":"Src","description":"The served URL of the picture thumbnail."},"logo":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Logo","description":"Whether the thumbnail is a logo."},"theme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Theme","description":"The theme of the thumbnail (e.g., light or dark)."},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"The width of the thumbnail."},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"The height of the thumbnail."},"bg_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bg Color","description":"The background color of the thumbnail."},"original":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original","description":"The original URL of the image."},"duplicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Duplicated","description":"Whether the thumbnail is a duplicate."}},"description":"Aggregated details representing a picture thumbnail."},{"type":"null"}],"description":"Page thumbnail: <code>src</code> is the proxied URL (ready to serve); <code>original</code> is the raw upstream URL."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The page’s own description, independent of the query (unlike <code>snippet</code>). Requires <code>enable_source_metadata</code>."},"robotstxt_status":{"anyOf":[{"enum":["allow","disallow","unknown"],"type":"string"},{"type":"null"}],"title":"Robotstxt Status","description":"Robots.txt status for the requested user-agent: allow, disallow, or unknown."},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fetched Content Timestamp","description":"Unix seconds of the index’s last fetch of this page. Requires <code>enable_source_metadata</code>."}},"description":"Minimal metadata for a referenced source URL."}},"grounding":{"type":"object","title":"LLMContext","properties":{"map":{"type":"array","items":{"type":"object","title":"LLMContextMapItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"The URL of the place."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the place."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the place."},"snippets":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Snippets","description":"The snippets about the place."}},"description":"A map/place item returned in the <code>map</code> array for local recall queries."},"title":"Map","default":[],"description":"Map/place results. When <code>enable_local</code> is enabled, the response may include map data."},"poi":{"anyOf":[{"type":"object","title":"LLMContextPOIItem","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"The URL of the point of interest."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the point of interest."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the point of interest."},"snippets":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Snippets","description":"The snippets about the point of interest."}},"description":"A point of interest item returned in the <code>poi</code> array for local recall queries."},{"type":"null"}],"description":"Point of interest data. When <code>enable_local</code> is enabled, the response may include POI data."},"generic":{"type":"array","items":{"type":"object","title":"LLMContextItem","properties":{"url":{"type":"string","title":"Url","default":"","description":"The source URL."},"title":{"type":"string","title":"Title","default":"","description":"The page title."},"snippets":{"type":"array","items":{"type":"string"},"title":"Snippets","default":[],"description":"Extracted text chunks from the page that are picked for their relevance to the query."}},"description":"A single LLM context item with URL, title, snippets, and optional last modified dates."},"title":"Generic","default":[],"description":"Array of LLM context items with extracted web content."}},"description":"Container for all LLM context content by type."}},"description":"Response model for the LLM Context API (/v1/llm/context)."},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P4LV8maP22nq0aV_i5YtT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","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":"Performs a web search via Brave and returns LLM-optimized context snippets with source metadata for a given query","exampleAgentPrompt":"Search the web for 'latest Federal Reserve interest rate decision 2024' using up to 10 results from the US and give me the relevant context snippets to answer my question.","exampleUseCases":[{"title":"Real-time news grounding for AI","prompt":"Search the web for 'OpenAI GPT-5 release date' with freshness set to the last 7 days and return the top 5 source snippets so I can answer questions accurately."},{"title":"Country-specific market research","prompt":"Find web context about 'electric vehicle adoption trends' from sources in Germany, using up to 15 results, so I can get a European perspective on the market."},{"title":"Prediction market context lookup","prompt":"Search Brave for 'US election prediction markets 2024 odds' and pull up to 20 results with snippets so I have grounded context for my analysis."}],"resultDescription":"Returns a structured JSON object with an LLM-ready context string and a sources map keyed by URL, where each source contains the page title, hostname, query-relevant snippet, publication age (full date, ISO date, relative age, ISO 8601 timestamp), favicon URL, thumbnail details, and site name.","failureModes":["Empty or missing query parameter returns validation error","Query exceeding 600 characters or 75 words is rejected","Unsupported country code causes parameter error","Count value outside 1-50 range returns validation error","No results found for highly specific or obscure query returns empty sources","Freshness filter with invalid date format causes error","Rate limiting or payment failure returns 402 or 429 error"],"whenToPreferThis":"Choose this endpoint when you need web search results pre-formatted as LLM context with source citations — especially when you want Brave's privacy-focused index with optional freshness filtering, country targeting, and custom re-ranking via Goggles. Prefer it over raw search endpoints when the agent needs to ground its answers in cited web content rather than just a list of URLs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:44:18.692Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-aisa-brave-llm-context-0b7c816e"}