{"uid":"cap_S1Rci4gtR31bDOAUpvCMy","slug":"aisa-mpp-data-apis-aisa-brave-llm-context-53ac8fe6","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":"POST","headers":{},"bodySchema":{"type":"object","title":"LLMContextParameters","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"}],"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_775cXnQJoMTijnSdM5VF9","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":"Runs a web search query via Brave and returns LLM-ready summarized context with sources, snippets, and metadata","exampleAgentPrompt":"Search the web for 'best treatments for type 2 diabetes in 2024' using Brave's LLM context API, returning up to 20 results from the US, filtered to pages from the last month.","exampleUseCases":[{"title":"Real-time news grounding for AI","prompt":"Search the web for the latest news on the Fed interest rate decision this week and give me summarized context with sources — I need up-to-date grounded info for my report, US results only, freshness within the last 7 days."},{"title":"Product research with cited sources","prompt":"Find me web context on 'top electric vehicles under $40,000 in 2024' — I want snippets and source URLs I can cite, up to 30 results, US market."},{"title":"Country-specific market lookup","prompt":"Do a Brave web search for 'current mortgage rates in Germany' and return LLM-ready context with sources, filtering to German results and pages from the past month."}],"resultDescription":"A JSON object containing a 'sources' map keyed by URL, where each source includes the page title, hostname, site name, a query-relevant snippet, favicon URL, thumbnail image info, and page age details (formatted date, ISO timestamp, relative age). Designed to be fed directly into an LLM as grounded context with citations.","failureModes":["Empty query (q is blank) returns validation error","Query exceeding 600 characters or 75 words is rejected","Unsupported country code returns error","Count value outside 1-50 range is rejected","Invalid freshness date range format causes error","No results found for obscure or malformed queries returns empty sources map"],"whenToPreferThis":"Choose this endpoint when you need web search results pre-formatted for LLM ingestion with rich source metadata (snippets, titles, favicons, ages) rather than raw HTML or full page content. Prefer it over generic search APIs when building RAG pipelines, agentic reasoning loops, or citation-grounded AI responses. It is particularly strong when you need freshness filtering, country-specific results, or Brave's Goggles re-ranking for custom result sets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T00:36:47.606Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-aisa-brave-llm-context-0b7c816e"}