{"openapi":"3.1.0","info":{"title":"typesearch · News search API","version":"1.0.0","description":"News search by topic: across an index of news outlets, on a live site, or for articles similar to a given one, judged by a calibrated relevance model. Compatible endpoints for Perplexity (/compat/perplexity), Exa (/compat/exa) and Tako (/compat/tako): see the migration guides at https://typesearch.ai/docs. For AI agents, a remote MCP server at /mcp (Streamable HTTP; tools search_news, get_contents, find_similar and create_chart) with the same key and prices. Custom indexes (/v1/indexes): search your own list of URLs, sitemap or feed with the same relevance model, passing `index` to /v1/search or search_news. Charts (/v1/charts): ask in plain words and get an embeddable chart card that picks the right chart, the key figures and a title that states the finding; or send your own data. Pricing, per 1,000 requests: ultra $1.00, fast $1.40, normal $2.20, deep $5.60; similar $2.20 ($4.60 in deep mode); live site search $2.40. Contents, per 1,000 pages: $0.20, or $0.40 with a query. Custom indexes: $2.00 per 1,000 URLs per month, billed daily; searches over them cost their mode. Charts: from a query, its search (the mode, per query) plus $0.50 per 1,000 charts; from your own data, $0.30 per 1,000; embeds and images are free. Each query in a multi-query request is billed as one search of its mode; cached results and failed requests are free. The same list, machine-readable, is in `x-pricing`."},"x-pricing":{"currency":"USD","per_1000_requests":{"ultra":1,"fast":1.4,"normal":2.2,"deep":5.6,"similar":2.2,"similar_deep":4.6,"site_search":2.4},"per_1000_pages":{"contents":0.2,"contents_with_query":0.4},"per_1000_urls_per_month":{"custom_index":2},"per_1000_charts":{"query_addon":0.5,"from_data":0.3}},"servers":[{"url":"https://api.typesearch.ai"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"SearchRequest":{"type":"object","properties":{"query":{"anyOf":[{"type":"string","minLength":2,"maxLength":200},{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","minLength":2,"maxLength":200}}],"description":"One query, or up to 5 judged together."},"index":{"description":"Search your own custom index (idx_…, see /v1/indexes) instead of the news index: the same modes, prices, questions and tone. One query per request; no date filter unless you pass days or dates.","type":"string","pattern":"^idx_[a-z0-9]{6,40}$"},"sources":{"description":"Only these index sources, by domain, such as example.com.","minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"include_domains":{"description":"Only these domains or paths. A domain includes its subdomains.","maxItems":20,"type":"array","items":{"type":"string","maxLength":200,"pattern":"^(https?:\\/\\/)?(\\*\\.)?[\\w-]+(\\.[\\w-]+)+(\\/\\S*)?$"}},"exclude_domains":{"description":"Never these domains or paths.","maxItems":20,"type":"array","items":{"type":"string","maxLength":200,"pattern":"^(https?:\\/\\/)?(\\*\\.)?[\\w-]+(\\.[\\w-]+)+(\\/\\S*)?$"}},"countries":{"description":"Only sources from these countries: ISO 3166-1 alpha-2 codes, such as AR or US.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","maxLength":20}},"languages":{"description":"Only sources that publish in these languages: ISO 639-1 codes, such as es or en (a BCP 47 tag such as pt-BR counts as pt).","minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":35}},"sections":{"description":"Only these sections: the section in the feed, or the start of the URL path.","maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"days":{"description":"The last N days; null for the whole index. Defaults to 7 unless dates are given.","anyOf":[{"type":"integer","minimum":1,"maximum":365},{"type":"null"}]},"published_after":{"description":"Published on or after this date. A bare date is read in Argentina time (UTC−3).","anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}]},"published_before":{"description":"Published on or before this date; a bare date includes that whole day.","anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}]},"mode":{"default":"normal","description":"ultra: headlines only, the cheapest · fast: headlines and standfirsts · normal: reads the best matches · deep: more headlines, the topic also in other words (synonyms and acronyms), twice the reading, snippets and the essentials of each article, and the search of the sites that cover the topic when the index falls short.","type":"string","enum":["ultra","fast","normal","deep"]},"max_results":{"default":10,"type":"integer","minimum":1,"maximum":50},"highlights":{"description":"Very short verbatim excerpts (up to 25 words, never from the first paragraph) from the articles that were read: one per article, two in deep mode. On by default only in deep mode.","type":"boolean"},"dedupe":{"default":false,"description":"Groups the same story reported by several outlets.","type":"boolean"},"tone":{"default":false,"description":"Tone toward the query: positive, neutral or negative.","type":"boolean"},"essential":{"description":"The essentials: very short verbatim excerpts across several articles. On by default only in deep mode.","type":"boolean"},"questions":{"default":{},"description":"Structured output: typed questions (boolean, choice, score) that the model answers for each result.","type":"object","propertyNames":{"type":"string","pattern":"^[\\w-]{1,40}$"},"additionalProperties":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SearchRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SearchRequest___schema0"}}]},"criteria":{"type":"object","properties":{"true":{"type":"string"},"false":{"type":"string"}}}},"required":["type","instructions"]},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SearchRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SearchRequest___schema0"}}]},"criteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","null"]}}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"score"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SearchRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SearchRequest___schema0"}}]},"criteria":{"minItems":2,"type":"array","items":{"type":"string"}}},"required":["type","instructions","criteria"]}]}},"max_tokens":{"default":null,"description":"Cap on model tokens. If it is reached, the response comes back with incomplete: true.","anyOf":[{"type":"integer","minimum":2000,"maximum":9007199254740991},{"type":"null"}]},"fresh":{"default":false,"description":"Skips the result cache (10 minutes).","type":"boolean"},"temporal":{"default":"auto","description":"auto: a date in the query («today», «yesterday», «tomorrow», «on September 22», «this week») is taken out of the topic, sets the publication window (unless published_after/before are given; days only bounds it) and puts the results from that day first · off: the query is taken literally.","type":"string","enum":["auto","off"]},"timezone":{"description":"IANA time zone that decides what day «today» is. Defaults to Argentina (America/Argentina/Buenos_Aires).","type":"string"},"stream":{"default":false,"description":"Server-sent events while it searches: step, partial, result.","type":"boolean"}},"required":["query"],"additionalProperties":false},"SearchRequest___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/SearchRequest___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SearchRequest___schema0"}}]},"SiteSearchRequest":{"type":"object","properties":{"site":{"type":"string","minLength":3,"maxLength":500,"description":"The live site to search, such as example.com."},"query":{"type":"string","minLength":2,"maxLength":200},"sections":{"description":"Only these sections: the section in the feed, or the start of the URL path.","maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"exclude_domains":{"description":"Never these domains or paths.","maxItems":20,"type":"array","items":{"type":"string","maxLength":200,"pattern":"^(https?:\\/\\/)?(\\*\\.)?[\\w-]+(\\.[\\w-]+)+(\\/\\S*)?$"}},"mode":{"default":"normal","description":"ultra: headlines only, the cheapest · fast: headlines and standfirsts · normal: reads the best matches · deep: more headlines, the topic also in other words (synonyms and acronyms), twice the reading, snippets and the essentials of each article, and the search of the sites that cover the topic when the index falls short.","type":"string","enum":["ultra","fast","normal","deep"]},"max_results":{"default":10,"type":"integer","minimum":1,"maximum":50},"highlights":{"description":"Very short verbatim excerpts (up to 25 words, never from the first paragraph) from the articles that were read: one per article, two in deep mode. On by default only in deep mode.","type":"boolean"},"dedupe":{"default":false,"description":"Groups the same story reported by several outlets.","type":"boolean"},"tone":{"default":false,"description":"Tone toward the query: positive, neutral or negative.","type":"boolean"},"essential":{"description":"The essentials: very short verbatim excerpts across several articles. On by default only in deep mode.","type":"boolean"},"questions":{"default":{},"description":"Structured output: typed questions (boolean, choice, score) that the model answers for each result.","type":"object","propertyNames":{"type":"string","pattern":"^[\\w-]{1,40}$"},"additionalProperties":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}}]},"criteria":{"type":"object","properties":{"true":{"type":"string"},"false":{"type":"string"}}}},"required":["type","instructions"]},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}}]},"criteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","null"]}}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"score"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}}]},"criteria":{"minItems":2,"type":"array","items":{"type":"string"}}},"required":["type","instructions","criteria"]}]}},"max_tokens":{"default":null,"description":"Cap on model tokens. If it is reached, the response comes back with incomplete: true.","anyOf":[{"type":"integer","minimum":2000,"maximum":9007199254740991},{"type":"null"}]},"fresh":{"default":false,"description":"Skips the result cache (10 minutes).","type":"boolean"},"temporal":{"default":"auto","description":"auto: a date in the query («today», «yesterday», «tomorrow», «on September 22», «this week») is taken out of the topic, sets the publication window (unless published_after/before are given; days only bounds it) and puts the results from that day first · off: the query is taken literally.","type":"string","enum":["auto","off"]},"timezone":{"description":"IANA time zone that decides what day «today» is. Defaults to Argentina (America/Argentina/Buenos_Aires).","type":"string"},"stream":{"default":false,"description":"Server-sent events instead of an asynchronous job.","type":"boolean"}},"required":["site","query"],"additionalProperties":false},"SiteSearchRequest___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SiteSearchRequest___schema0"}}]},"SimilarRequest":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri"},"sources":{"description":"Only these index sources, by domain, such as example.com.","minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"include_domains":{"description":"Only these domains or paths. A domain includes its subdomains.","maxItems":20,"type":"array","items":{"type":"string","maxLength":200,"pattern":"^(https?:\\/\\/)?(\\*\\.)?[\\w-]+(\\.[\\w-]+)+(\\/\\S*)?$"}},"exclude_domains":{"description":"Never these domains or paths.","maxItems":20,"type":"array","items":{"type":"string","maxLength":200,"pattern":"^(https?:\\/\\/)?(\\*\\.)?[\\w-]+(\\.[\\w-]+)+(\\/\\S*)?$"}},"countries":{"description":"Only sources from these countries: ISO 3166-1 alpha-2 codes, such as AR or US.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","maxLength":20}},"languages":{"description":"Only sources that publish in these languages: ISO 639-1 codes, such as es or en (a BCP 47 tag such as pt-BR counts as pt).","minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":35}},"sections":{"description":"Only these sections: the section in the feed, or the start of the URL path.","maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"days":{"description":"The last N days; null for the whole index. Defaults to 7 unless dates are given.","anyOf":[{"type":"integer","minimum":1,"maximum":365},{"type":"null"}]},"published_after":{"description":"Published on or after this date. A bare date is read in Argentina time (UTC−3).","anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}]},"published_before":{"description":"Published on or before this date; a bare date includes that whole day.","anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}]},"mode":{"default":"normal","description":"ultra: headlines only, the cheapest · fast: headlines and standfirsts · normal: reads the best matches · deep: more headlines, the topic also in other words (synonyms and acronyms), twice the reading, snippets and the essentials of each article, and the search of the sites that cover the topic when the index falls short.","type":"string","enum":["ultra","fast","normal","deep"]},"max_results":{"default":10,"type":"integer","minimum":1,"maximum":50},"highlights":{"description":"Very short verbatim excerpts (up to 25 words, never from the first paragraph) from the articles that were read: one per article, two in deep mode. On by default only in deep mode.","type":"boolean"},"dedupe":{"default":false,"description":"Groups the same story reported by several outlets.","type":"boolean"},"tone":{"default":false,"description":"Tone toward the query: positive, neutral or negative.","type":"boolean"},"essential":{"description":"The essentials: very short verbatim excerpts across several articles. On by default only in deep mode.","type":"boolean"},"questions":{"default":{},"description":"Structured output: typed questions (boolean, choice, score) that the model answers for each result.","type":"object","propertyNames":{"type":"string","pattern":"^[\\w-]{1,40}$"},"additionalProperties":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SimilarRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SimilarRequest___schema0"}}]},"criteria":{"type":"object","properties":{"true":{"type":"string"},"false":{"type":"string"}}}},"required":["type","instructions"]},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SimilarRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SimilarRequest___schema0"}}]},"criteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","null"]}}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"score"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SimilarRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/SimilarRequest___schema0"}}]},"criteria":{"minItems":2,"type":"array","items":{"type":"string"}}},"required":["type","instructions","criteria"]}]}},"max_tokens":{"default":null,"description":"Cap on model tokens. If it is reached, the response comes back with incomplete: true.","anyOf":[{"type":"integer","minimum":2000,"maximum":9007199254740991},{"type":"null"}]},"fresh":{"default":false,"description":"Skips the result cache (10 minutes).","type":"boolean"},"temporal":{"default":"auto","description":"auto: a date in the query («today», «yesterday», «tomorrow», «on September 22», «this week») is taken out of the topic, sets the publication window (unless published_after/before are given; days only bounds it) and puts the results from that day first · off: the query is taken literally.","type":"string","enum":["auto","off"]},"timezone":{"description":"IANA time zone that decides what day «today» is. Defaults to Argentina (America/Argentina/Buenos_Aires).","type":"string"}},"required":["url"],"additionalProperties":false},"SimilarRequest___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/SimilarRequest___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/SimilarRequest___schema0"}}]},"ContentsRequest":{"type":"object","properties":{"urls":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}},"query":{"description":"With a query, the model picks the excerpt about it and says how much each article covers it.","type":"string","minLength":2,"maxLength":200},"highlights":{"default":true,"type":"boolean"},"max_tokens":{"default":null,"description":"Cap on model tokens. If it is reached, the response comes back with incomplete: true.","anyOf":[{"type":"integer","minimum":2000,"maximum":9007199254740991},{"type":"null"}]}},"required":["urls"],"additionalProperties":false},"SearchResponse":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","enum":["search","site_search","similar"]},"mode":{"type":"string","enum":["ultra","fast","normal","deep"]},"queries":{"type":"array","items":{"type":"string"}},"found":{"type":"boolean"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"groups":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"found":{"type":"boolean"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"near_misses":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"rejected":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"diffusion":{"anyOf":[{"type":"object","properties":{"by_day":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["day","count"],"additionalProperties":false}},"by_source":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_published_at":{"type":"string"}},"required":["source","count","first_published_at"],"additionalProperties":false}},"first":{"anyOf":[{"type":"object","properties":{"source":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":"string"},"published_at":{"type":"string"}},"required":["source","url","title","published_at"],"additionalProperties":false},{"type":"null"}]},"undated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["by_day","by_source","first","undated"],"additionalProperties":false},{"type":"null"}]},"tone":{"anyOf":[{"type":"object","properties":{"articles":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"overall":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["positive","neutral","negative"],"additionalProperties":false},"by_source":{"type":"array","items":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"string"}},"required":["positive","neutral","negative","source"],"additionalProperties":false}}},"required":["articles","overall","by_source"],"additionalProperties":false},{"type":"null"}]},"essential":{"anyOf":[{"type":"object","properties":{"excerpts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string"},"source":{"type":["string","null"]},"title":{"type":"string"}},"required":["text","url","source","title"],"additionalProperties":false}}},"required":["excerpts"],"additionalProperties":false},{"type":"null"}]},"temporal":{"anyOf":[{"type":"object","properties":{"expression":{"description":"The date words in the query, such as «hoy»; null when the query asks for the latest without naming a date.","type":["string","null"]},"from":{"description":"First day of the period the query refers to (YYYY-MM-DD, in `timezone`).","type":["string","null"]},"to":{"description":"Last day of that period; the same as `from` for a single day.","type":["string","null"]},"timezone":{"type":"string"},"basis":{"type":"string","enum":["published","event","recency"],"description":"published: what was published about that day · event: news about what is scheduled for that day (published before it) · recency: the query asks for the latest without naming a date, so the newest go first."},"window":{"anyOf":[{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},{"type":"null"}],"description":"The publication window the date set, when it did. Null when published_after/before (or days) in the request took precedence: then the date only sorts."},"widened":{"type":"boolean","description":"No result is from the requested day: they come from the days around it."}},"required":["expression","from","to","timezone","basis","window","widened"],"additionalProperties":false},{"type":"null"}],"description":"How the date in the query was read: the topic was judged without it, and the results from that day go first. Null when the query names none."}},"required":["query","found","total","results","near_misses","rejected","diffusion","tone","essential","temporal"],"additionalProperties":false}},{"type":"null"}],"description":"With several queries: the breakdown for each one."},"near_misses":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false},"description":"If nothing was found: the closest matches."},"rejected":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false},"description":"The headline looked relevant, but reading the article ruled it out."},"diffusion":{"anyOf":[{"type":"object","properties":{"by_day":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["day","count"],"additionalProperties":false}},"by_source":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_published_at":{"type":"string"}},"required":["source","count","first_published_at"],"additionalProperties":false}},"first":{"anyOf":[{"type":"object","properties":{"source":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":"string"},"published_at":{"type":"string"}},"required":["source","url","title","published_at"],"additionalProperties":false},{"type":"null"}]},"undated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["by_day","by_source","first","undated"],"additionalProperties":false},{"type":"null"}]},"tone":{"anyOf":[{"type":"object","properties":{"articles":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"overall":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["positive","neutral","negative"],"additionalProperties":false},"by_source":{"type":"array","items":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"string"}},"required":["positive","neutral","negative","source"],"additionalProperties":false}}},"required":["articles","overall","by_source"],"additionalProperties":false},{"type":"null"}]},"essential":{"anyOf":[{"type":"object","properties":{"excerpts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string"},"source":{"type":["string","null"]},"title":{"type":"string"}},"required":["text","url","source","title"],"additionalProperties":false}}},"required":["excerpts"],"additionalProperties":false},{"type":"null"}]},"reference":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"}},"required":["url","title"],"additionalProperties":false},{"type":"null"}]},"custom_index":{"description":"With `index`: the custom index that was searched.","anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"temporal":{"anyOf":[{"type":"object","properties":{"expression":{"description":"The date words in the query, such as «hoy»; null when the query asks for the latest without naming a date.","type":["string","null"]},"from":{"description":"First day of the period the query refers to (YYYY-MM-DD, in `timezone`).","type":["string","null"]},"to":{"description":"Last day of that period; the same as `from` for a single day.","type":["string","null"]},"timezone":{"type":"string"},"basis":{"type":"string","enum":["published","event","recency"],"description":"published: what was published about that day · event: news about what is scheduled for that day (published before it) · recency: the query asks for the latest without naming a date, so the newest go first."},"window":{"anyOf":[{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},{"type":"null"}],"description":"The publication window the date set, when it did. Null when published_after/before (or days) in the request took precedence: then the date only sorts."},"widened":{"type":"boolean","description":"No result is from the requested day: they come from the days around it."}},"required":["expression","from","to","timezone","basis","window","widened"],"additionalProperties":false},{"type":"null"}],"description":"How the date in the query was read: the topic was judged without it, and the results from that day go first. Null when the query names none."},"site":{"type":["string","null"]},"index":{"anyOf":[{"type":"object","properties":{"updated_at":{"description":"The oldest last refresh among the sources searched: how fresh the index was for this request.","type":["string","null"]}},"required":["updated_at"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Model tokens used by this request. 0 when it came from the cache."},"calls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_usd":{"description":"What this request was billed, in USD: the list price of its mode (see `pricing` in GET /v1/usage), per query. 0 when it came from the cache. Null in partial results.","type":["number","null"]},"headlines":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"from_memory":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pages_direct":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pages_browser":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"duration_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["tokens","calls","cost_usd","headlines","from_memory","pages_direct","pages_browser","duration_ms"],"additionalProperties":false},"budget":{"anyOf":[{"type":"object","properties":{"max_tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"exhausted":{"type":"boolean"}},"required":["max_tokens","used","exhausted"],"additionalProperties":false},{"type":"null"}]},"discovery":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["used","background","skipped","budget","timeout"],"description":"used: it searched beyond the index within the time budget · background: in ultra or fast there was nothing to check quickly; it keeps learning in the background · skipped: the index had enough, or it does not apply · budget: the discovery limit was reached · timeout: the time budget ran out (incomplete: true)."},"sites":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Sites beyond the index that contributed candidates."},"ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Time it added to this request, in milliseconds."}},"required":["status","sites","ms"],"additionalProperties":false},{"type":"null"}],"description":"Discovery: when the index has fewer than 3 good matches, typesearch looks for sources beyond it and reads them at the original site. Null only in partial events, while it is still running."},"incomplete":{"type":"boolean","description":"The token cap (max_tokens) or the discovery time budget ran out: there may be more."},"cached_at":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["id","object","mode","queries","found","total","results","groups","near_misses","rejected","diffusion","tone","essential","reference","temporal","site","index","usage","budget","discovery","incomplete","cached_at","warnings"],"additionalProperties":false},"ContentsResponse":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"contents"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","enum":["ok","error"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"published_at":{"type":["string","null"]},"source":{"type":["string","null"]},"excerpt":{"description":"A very short verbatim excerpt (up to 25 words), never from the first paragraph: the one about the query if there is one. Null when the article can’t be quoted (short, paid, or the publisher asked for no snippets).","type":["string","null"]},"highlights":{"type":"array","items":{"type":"string"}},"relevance":{"description":"With query: probability that the article is about it.","type":["number","null"]}},"required":["url","status","error","title","description","published_at","source","excerpt","highlights","relevance"],"additionalProperties":false}},"usage":{"type":"object","properties":{"tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Model tokens used by this request. 0 when it came from the cache."},"calls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_usd":{"description":"What this request was billed, in USD: the list price of its mode (see `pricing` in GET /v1/usage), per query. 0 when it came from the cache. Null in partial results.","type":["number","null"]},"duration_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["tokens","calls","cost_usd","duration_ms"],"additionalProperties":false}},"required":["id","object","results","usage"],"additionalProperties":false},"Job":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"job"},"status":{"type":"string","enum":["queued","running","succeeded","failed"]},"created_at":{"type":"string"},"finished_at":{"type":["string","null"]},"result":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","enum":["search","site_search","similar"]},"mode":{"type":"string","enum":["ultra","fast","normal","deep"]},"queries":{"type":"array","items":{"type":"string"}},"found":{"type":"boolean"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"groups":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"found":{"type":"boolean"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"near_misses":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"rejected":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false}},"diffusion":{"anyOf":[{"type":"object","properties":{"by_day":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["day","count"],"additionalProperties":false}},"by_source":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_published_at":{"type":"string"}},"required":["source","count","first_published_at"],"additionalProperties":false}},"first":{"anyOf":[{"type":"object","properties":{"source":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":"string"},"published_at":{"type":"string"}},"required":["source","url","title","published_at"],"additionalProperties":false},{"type":"null"}]},"undated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["by_day","by_source","first","undated"],"additionalProperties":false},{"type":"null"}]},"tone":{"anyOf":[{"type":"object","properties":{"articles":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"overall":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["positive","neutral","negative"],"additionalProperties":false},"by_source":{"type":"array","items":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"string"}},"required":["positive","neutral","negative","source"],"additionalProperties":false}}},"required":["articles","overall","by_source"],"additionalProperties":false},{"type":"null"}]},"essential":{"anyOf":[{"type":"object","properties":{"excerpts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string"},"source":{"type":["string","null"]},"title":{"type":"string"}},"required":["text","url","source","title"],"additionalProperties":false}}},"required":["excerpts"],"additionalProperties":false},{"type":"null"}]},"temporal":{"anyOf":[{"type":"object","properties":{"expression":{"description":"The date words in the query, such as «hoy»; null when the query asks for the latest without naming a date.","type":["string","null"]},"from":{"description":"First day of the period the query refers to (YYYY-MM-DD, in `timezone`).","type":["string","null"]},"to":{"description":"Last day of that period; the same as `from` for a single day.","type":["string","null"]},"timezone":{"type":"string"},"basis":{"type":"string","enum":["published","event","recency"],"description":"published: what was published about that day · event: news about what is scheduled for that day (published before it) · recency: the query asks for the latest without naming a date, so the newest go first."},"window":{"anyOf":[{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},{"type":"null"}],"description":"The publication window the date set, when it did. Null when published_after/before (or days) in the request took precedence: then the date only sorts."},"widened":{"type":"boolean","description":"No result is from the requested day: they come from the days around it."}},"required":["expression","from","to","timezone","basis","window","widened"],"additionalProperties":false},{"type":"null"}],"description":"How the date in the query was read: the topic was judged without it, and the results from that day go first. Null when the query names none."}},"required":["query","found","total","results","near_misses","rejected","diffusion","tone","essential","temporal"],"additionalProperties":false}},{"type":"null"}],"description":"With several queries: the breakdown for each one."},"near_misses":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false},"description":"If nothing was found: the closest matches."},"rejected":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"country":{"description":"Country of the source (ISO 3166-1 alpha-2), when known.","type":["string","null"]},"language":{"description":"Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.","type":["string","null"]},"published_at":{"type":["string","null"]},"section":{"type":["string","null"]},"snippet":{"description":"The standfirst or description, as the outlet published it.","type":["string","null"]},"score":{"type":"number","description":"Probability that the article is about the query: from reading it if it was read, otherwise from its headline."},"headline_relevance":{"type":"number"},"read":{"anyOf":[{"type":"object","properties":{"probability":{"type":"number"},"centrality":{"type":"number","description":"0 not mentioned · 3 main topic."}},"required":["probability","centrality"],"additionalProperties":false},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"tone":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","enum":["positive","neutral","negative"]},"probabilities":{"type":"object","propertyNames":{"type":"string","enum":["positive","neutral","negative"]},"additionalProperties":{"type":"number"},"required":["positive","neutral","negative"]},"basis":{"type":"string","enum":["article","headline"]}},"required":["label","probabilities","basis"],"additionalProperties":false},{"type":"null"}]},"answers":{"anyOf":[{"type":"object","properties":{"basis":{"type":"string","enum":["article","headline"]},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"choice":{"type":"string"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","choice"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"score"},"score":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"confidence":{"type":"number"}},"required":["type","score"],"additionalProperties":false}]}}},"required":["basis","values"],"additionalProperties":false},{"type":"null"}]},"duplicates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]}},"required":["url","title","source"],"additionalProperties":false}},"date_match":{"anyOf":[{"type":"string","enum":["exact","adjacent","unknown","outside"]},{"type":"null"}],"description":"When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."},"referenced_date":{"description":"When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.","type":["string","null"]},"found_in":{"type":"string","enum":["index","homepage","section","site_search","discovery","custom_index"],"description":"Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."},"data":{"description":"Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.","anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}]},"queries":{"description":"With several queries: which ones this result belongs to.","type":"array","items":{"type":"string"}}},"required":["url","title","source","country","language","published_at","section","snippet","score","headline_relevance","read","highlights","tone","answers","duplicates","date_match","referenced_date","found_in"],"additionalProperties":false},"description":"The headline looked relevant, but reading the article ruled it out."},"diffusion":{"anyOf":[{"type":"object","properties":{"by_day":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["day","count"],"additionalProperties":false}},"by_source":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_published_at":{"type":"string"}},"required":["source","count","first_published_at"],"additionalProperties":false}},"first":{"anyOf":[{"type":"object","properties":{"source":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":"string"},"published_at":{"type":"string"}},"required":["source","url","title","published_at"],"additionalProperties":false},{"type":"null"}]},"undated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["by_day","by_source","first","undated"],"additionalProperties":false},{"type":"null"}]},"tone":{"anyOf":[{"type":"object","properties":{"articles":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"overall":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["positive","neutral","negative"],"additionalProperties":false},"by_source":{"type":"array","items":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"string"}},"required":["positive","neutral","negative","source"],"additionalProperties":false}}},"required":["articles","overall","by_source"],"additionalProperties":false},{"type":"null"}]},"essential":{"anyOf":[{"type":"object","properties":{"excerpts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string"},"source":{"type":["string","null"]},"title":{"type":"string"}},"required":["text","url","source","title"],"additionalProperties":false}}},"required":["excerpts"],"additionalProperties":false},{"type":"null"}]},"reference":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"}},"required":["url","title"],"additionalProperties":false},{"type":"null"}]},"custom_index":{"description":"With `index`: the custom index that was searched.","anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"temporal":{"anyOf":[{"type":"object","properties":{"expression":{"description":"The date words in the query, such as «hoy»; null when the query asks for the latest without naming a date.","type":["string","null"]},"from":{"description":"First day of the period the query refers to (YYYY-MM-DD, in `timezone`).","type":["string","null"]},"to":{"description":"Last day of that period; the same as `from` for a single day.","type":["string","null"]},"timezone":{"type":"string"},"basis":{"type":"string","enum":["published","event","recency"],"description":"published: what was published about that day · event: news about what is scheduled for that day (published before it) · recency: the query asks for the latest without naming a date, so the newest go first."},"window":{"anyOf":[{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},{"type":"null"}],"description":"The publication window the date set, when it did. Null when published_after/before (or days) in the request took precedence: then the date only sorts."},"widened":{"type":"boolean","description":"No result is from the requested day: they come from the days around it."}},"required":["expression","from","to","timezone","basis","window","widened"],"additionalProperties":false},{"type":"null"}],"description":"How the date in the query was read: the topic was judged without it, and the results from that day go first. Null when the query names none."},"site":{"type":["string","null"]},"index":{"anyOf":[{"type":"object","properties":{"updated_at":{"description":"The oldest last refresh among the sources searched: how fresh the index was for this request.","type":["string","null"]}},"required":["updated_at"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Model tokens used by this request. 0 when it came from the cache."},"calls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_usd":{"description":"What this request was billed, in USD: the list price of its mode (see `pricing` in GET /v1/usage), per query. 0 when it came from the cache. Null in partial results.","type":["number","null"]},"headlines":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"from_memory":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pages_direct":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pages_browser":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"duration_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["tokens","calls","cost_usd","headlines","from_memory","pages_direct","pages_browser","duration_ms"],"additionalProperties":false},"budget":{"anyOf":[{"type":"object","properties":{"max_tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"exhausted":{"type":"boolean"}},"required":["max_tokens","used","exhausted"],"additionalProperties":false},{"type":"null"}]},"discovery":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["used","background","skipped","budget","timeout"],"description":"used: it searched beyond the index within the time budget · background: in ultra or fast there was nothing to check quickly; it keeps learning in the background · skipped: the index had enough, or it does not apply · budget: the discovery limit was reached · timeout: the time budget ran out (incomplete: true)."},"sites":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Sites beyond the index that contributed candidates."},"ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Time it added to this request, in milliseconds."}},"required":["status","sites","ms"],"additionalProperties":false},{"type":"null"}],"description":"Discovery: when the index has fewer than 3 good matches, typesearch looks for sources beyond it and reads them at the original site. Null only in partial events, while it is still running."},"incomplete":{"type":"boolean","description":"The token cap (max_tokens) or the discovery time budget ran out: there may be more."},"cached_at":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["id","object","mode","queries","found","total","results","groups","near_misses","rejected","diffusion","tone","essential","reference","temporal","site","index","usage","budget","discovery","incomplete","cached_at","warnings"],"additionalProperties":false},{"type":"null"}]},"error":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"detail":{"type":"string"},"code":{"type":"string"},"request_id":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status","detail","code","request_id"],"additionalProperties":false},{"type":"null"}]}},"required":["id","object","status","created_at","finished_at","result","error"],"additionalProperties":false},"Usage":{"type":"object","properties":{"object":{"type":"string","const":"usage"},"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"limits":{"type":"object","properties":{"tokens_per_day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"requests_per_minute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"requests_per_second":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["tokens_per_day","requests_per_minute","requests_per_second"],"additionalProperties":false},"today":{"type":"object","properties":{"requests":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_usd":{"type":"number"},"remaining_tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["requests","tokens","cost_usd","remaining_tokens"],"additionalProperties":false},"last_30_days":{"type":"object","properties":{"requests":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_usd":{"type":"number"}},"required":["requests","tokens","cost_usd"],"additionalProperties":false},"credit":{"anyOf":[{"type":"object","properties":{"balance_usd":{"type":"number"},"plan":{"type":"string","enum":["payg","plan"]},"spent_this_month_usd":{"type":"number"},"monthly_limit_usd":{"type":["number","null"]}},"required":["balance_usd","plan","spent_this_month_usd","monthly_limit_usd"],"additionalProperties":false},{"type":"null"}],"description":"The organization credit behind this key. Null for internal keys, which are not billed."},"pricing":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"per_1000_requests":{"type":"object","properties":{"ultra":{"type":"number"},"fast":{"type":"number"},"normal":{"type":"number"},"deep":{"type":"number"},"similar":{"type":"number"},"similar_deep":{"type":"number","description":"Similar in deep mode, which reads eight articles and returns highlights."},"site_search":{"type":"number"}},"required":["ultra","fast","normal","deep","similar","similar_deep","site_search"],"additionalProperties":false},"per_1000_pages":{"type":"object","properties":{"contents":{"type":"number"},"contents_with_query":{"type":"number","description":"With a query, the model reads each page and picks the excerpts."}},"required":["contents","contents_with_query"],"additionalProperties":false},"per_1000_urls_per_month":{"type":"object","properties":{"custom_index":{"type":"number","description":"Each URL in your custom indexes, billed daily (a thirtieth per day); searches over them cost their mode."}},"required":["custom_index"],"additionalProperties":false},"per_1000_charts":{"type":"object","properties":{"query_addon":{"type":"number","description":"A chart from a query: its search (the mode, per query) plus this."},"from_data":{"type":"number","description":"A chart from your own data."}},"required":["query_addon","from_data"],"additionalProperties":false}},"required":["currency","per_1000_requests","per_1000_pages","per_1000_urls_per_month","per_1000_charts"],"additionalProperties":false,"description":"The list prices: per 1,000 requests for each search mode, similar and live site search (each query in a multi-query request is one search of its mode), per 1,000 pages for contents, per 1,000 URLs per month for custom indexes, and per 1,000 charts."}},"required":["object","key","limits","today","last_30_days","credit","pricing"],"additionalProperties":false},"Problem":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"detail":{"type":"string"},"code":{"type":"string"},"request_id":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status","detail","code","request_id"],"additionalProperties":false},"IndexRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80}},"required":["name"],"additionalProperties":false},"IndexUrlsRequest":{"type":"object","properties":{"urls":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","maxLength":2100}},"sitemap":{"type":"string","minLength":1,"maxLength":2000},"feed":{"type":"string","minLength":1,"maxLength":2000}},"additionalProperties":false},"IndexUrlsDeleteRequest":{"type":"object","properties":{"urls":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","maxLength":2100}},"sources":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":2100}}},"additionalProperties":false},"Index":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"index"},"name":{"type":"string"},"status":{"type":"string","enum":["active","paused"],"description":"paused: no credit left, so it is not re-read (nor billed) until there is."},"urls":{"type":"object","properties":{"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pending":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"blocked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["total","ready","pending","failed","blocked"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"type":{"type":"string","enum":["sitemap","feed"]},"status":{"type":"string","enum":["pending","ok","failed"]},"read_at":{"type":["string","null"]},"urls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"URLs it listed the last time it was read."},"error":{"type":["string","null"]}},"required":["url","type","status","read_at","urls","error"],"additionalProperties":false},"description":"Sitemaps and feeds: read every hour; new URLs are added (up to your limit) and updated ones re-read."},"cost_per_day_usd":{"type":"number","description":"What its URLs cost per day right now (US$2.00 per 1,000 URLs per month, a thirtieth per day)."},"last_read_at":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","name","status","urls","sources","cost_per_day_usd","last_read_at","created_at","updated_at"],"additionalProperties":false},"IndexList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"indexes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"index"},"name":{"type":"string"},"status":{"type":"string","enum":["active","paused"],"description":"paused: no credit left, so it is not re-read (nor billed) until there is."},"urls":{"type":"object","properties":{"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pending":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"blocked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["total","ready","pending","failed","blocked"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"type":{"type":"string","enum":["sitemap","feed"]},"status":{"type":"string","enum":["pending","ok","failed"]},"read_at":{"type":["string","null"]},"urls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"URLs it listed the last time it was read."},"error":{"type":["string","null"]}},"required":["url","type","status","read_at","urls","error"],"additionalProperties":false},"description":"Sitemaps and feeds: read every hour; new URLs are added (up to your limit) and updated ones re-read."},"cost_per_day_usd":{"type":"number","description":"What its URLs cost per day right now (US$2.00 per 1,000 URLs per month, a thirtieth per day)."},"last_read_at":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","name","status","urls","sources","cost_per_day_usd","last_read_at","created_at","updated_at"],"additionalProperties":false}},"limits":{"type":"object","properties":{"urls":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"URLs you can have across all your custom indexes; null is unlimited. Pay as you go 100, Monthly credit plan 10,000, Enterprise unlimited."},"urls_used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indexes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"indexes_used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["urls","urls_used","indexes","indexes_used"],"additionalProperties":false,"description":"Your plan’s custom-index limits."}},"required":["object","indexes","limits"],"additionalProperties":false},"IndexUrlsResponse":{"type":"object","properties":{"index":{"type":"string"},"added":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"existing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"invalid":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"reason":{"type":"string"}},"required":["url","reason"],"additionalProperties":false}},"over_limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"URLs that did not fit in your plan’s limit (see warnings: the next plan allows more)."},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"type":{"type":"string","enum":["sitemap","feed"]},"status":{"type":"string","enum":["pending","ok","failed"]},"read_at":{"type":["string","null"]},"urls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"URLs it listed the last time it was read."},"error":{"type":["string","null"]}},"required":["url","type","status","read_at","urls","error"],"additionalProperties":false}},"limits":{"type":"object","properties":{"urls":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"URLs you can have across all your custom indexes; null is unlimited. Pay as you go 100, Monthly credit plan 10,000, Enterprise unlimited."},"urls_used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indexes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"indexes_used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["urls","urls_used","indexes","indexes_used"],"additionalProperties":false,"description":"Your plan’s custom-index limits."},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["index","added","existing","invalid","over_limit","total","sources","limits","warnings"],"additionalProperties":false},"IndexUrlList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"urls":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","enum":["pending","ready","failed","blocked"],"description":"blocked: robots.txt, a publisher request or a bot check does not allow it; tried again in a week."},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"data":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},{"type":"null"}],"description":"Structured data the page declares: price, currency, availability, brand, sku…"},"published_at":{"type":["string","null"]},"read_at":{"type":["string","null"]},"changed_at":{"type":["string","null"]},"next_read_at":{"type":["string","null"]},"error":{"type":["string","null"]}},"required":["url","status","title","description","data","published_at","read_at","changed_at","next_read_at","error"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["object","urls","next_cursor"],"additionalProperties":false},"ChartRequest":{"type":"object","properties":{"query":{"description":"What you want to see, in plain words: «blue dollar this week», «Milei vs Bullrich coverage», «prices in my catalog».","type":"string","minLength":2,"maxLength":200},"data":{"type":"object","properties":{"series":{"default":[],"maxItems":12,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"points":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"x":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"number"}]},"y":{"type":"number"},"r":{"type":"number","minimum":0},"label":{"type":"string","maxLength":120}},"required":["x","y"]}},"role":{"type":"string","enum":["positive","neutral","negative","other"]}},"required":["name","points"]}},"x":{"type":"object","properties":{"kind":{"type":"string","enum":["time","category","number"]},"label":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":16},"granularity":{"type":"string","enum":["hour","day","week","month","year"]}}},"y":{"type":"object","properties":{"label":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":16},"format":{"type":"string","enum":["number","percent","currency"]},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"decimals":{"type":"integer","minimum":0,"maximum":6},"higher_is_better":{"type":"boolean"}}},"x_measure":{"type":"object","properties":{"label":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":16},"format":{"type":"string","enum":["number","percent","currency"]},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"decimals":{"type":"integer","minimum":0,"maximum":6},"higher_is_better":{"type":"boolean"}}},"events":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"label":{"type":"string","minLength":1,"maxLength":200},"detail":{"type":"string","maxLength":200}},"required":["date","label"]}},"columns":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":40},"label":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"object","properties":{"label":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":16},"format":{"type":"string","enum":["number","percent","currency"]},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"decimals":{"type":"integer","minimum":0,"maximum":6},"higher_is_better":{"type":"boolean"}}}},"required":["key","label"]}},"rows":{"maxItems":100,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"null"}]}}},"highlight":{"type":"string","maxLength":120}},"description":"Your own data: series of points (x, y), or events, or columns and rows."},"type":{"default":"auto","description":"The chart type. auto (the default) picks the one that tells the data best; any other forces it while the data allows.","type":"string","enum":["auto","line","area","bar","bar_horizontal","stacked_bar","pie","donut","scatter","funnel","timeline","kpi","table"]},"index":{"description":"Build the chart from your custom index (idx_…) instead of the news: prices, ratings, availability and brands.","type":"string","pattern":"^idx_[a-z0-9]{6,40}$"},"mode":{"default":"auto","description":"auto: the cheapest mode that gets the data (coverage in ultra, figures in fast, reading articles only if needed). Or fix it.","type":"string","enum":["auto","ultra","fast","normal","deep"]},"compare":{"description":"What to compare (2 to 5), if the query does not say it with «vs».","minItems":2,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"questions":{"description":"One typed question (boolean, choice, score): the chart shows how the answers split across the articles.","type":"object","propertyNames":{"type":"string","pattern":"^[\\w-]{1,40}$"},"additionalProperties":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"boolean"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/ChartRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/ChartRequest___schema0"}}]},"criteria":{"type":"object","properties":{"true":{"type":"string"},"false":{"type":"string"}}}},"required":["type","instructions"]},{"type":"object","properties":{"type":{"type":"string","const":"choice"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/ChartRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/ChartRequest___schema0"}}]},"criteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","null"]}}},"required":["type","instructions","criteria"]},{"type":"object","properties":{"type":{"type":"string","const":"score"},"instructions":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/ChartRequest___schema0"}},{"type":"array","items":{"$ref":"#/components/schemas/ChartRequest___schema0"}}]},"criteria":{"minItems":2,"type":"array","items":{"type":"string"}}},"required":["type","instructions","criteria"]}]}},"days":{"description":"The last N days. By default it depends on what is measured: 30 for coverage, share of voice and outlets, 14 for tone, 60 for a timeline, 7 for figures.","anyOf":[{"type":"integer","minimum":1,"maximum":365},{"type":"null"}]},"published_after":{"description":"Published on or after this date. A bare date is read in Argentina time (UTC−3).","anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}]},"published_before":{"description":"Published on or before this date; a bare date includes that whole day.","anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}]},"countries":{"description":"Only sources from these countries: ISO 3166-1 alpha-2 codes, such as AR or US.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","maxLength":20}},"languages":{"description":"Only sources that publish in these languages: ISO 639-1 codes, such as es or en (a BCP 47 tag such as pt-BR counts as pt).","minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":35}},"include_domains":{"description":"Only these domains or paths. A domain includes its subdomains.","maxItems":20,"type":"array","items":{"type":"string","maxLength":200,"pattern":"^(https?:\\/\\/)?(\\*\\.)?[\\w-]+(\\.[\\w-]+)+(\\/\\S*)?$"}},"exclude_domains":{"description":"Never these domains or paths.","maxItems":20,"type":"array","items":{"type":"string","maxLength":200,"pattern":"^(https?:\\/\\/)?(\\*\\.)?[\\w-]+(\\.[\\w-]+)+(\\/\\S*)?$"}},"timezone":{"description":"IANA time zone that decides what day «today» is. Defaults to Argentina (America/Argentina/Buenos_Aires).","type":"string"},"title":{"description":"Your title. Without one, the chart gets a title that states the finding.","type":"string","minLength":1,"maxLength":160},"subtitle":{"type":"string","minLength":1,"maxLength":240},"source":{"description":"The source line in the footer, for your own data.","type":"string","minLength":1,"maxLength":160},"theme":{"default":"light","description":"light, dark, editorial (warm paper, for media) or electric (deep blue, for presentations).","type":"string","enum":["light","dark","editorial","electric"]},"locale":{"description":"Language of titles, labels and numbers. Defaults to Accept-Language.","type":"string","enum":["en","es"]},"interpretation":{"description":"One of `interpretation.alternatives` from a previous response: chart that reading of the query instead.","type":"string","minLength":1,"maxLength":160},"plan_only":{"default":false,"description":"Only the plan: what we understood, what would be measured, the chart type and the data needed. Free, without searching.","type":"boolean"},"stream":{"default":false,"description":"Server-sent events: `step` while it works, `result` with the chart and, if a better chart arrives after the deadline, `improved`.","type":"boolean"},"store":{"default":true,"description":"false: nothing is stored (no embed_url); the SVG comes in the response.","type":"boolean"},"include_svg":{"default":false,"description":"Include the SVG in the response.","type":"boolean"}},"additionalProperties":false},"ChartRequest___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/ChartRequest___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/ChartRequest___schema0"}}]},"ChartUpdateRequest":{"type":"object","properties":{"type":{"type":"string","enum":["line","area","bar","bar_horizontal","stacked_bar","pie","donut","scatter","funnel","timeline","kpi","table"]},"theme":{"type":"string","enum":["light","dark","editorial","electric"]},"title":{"type":"string","minLength":1,"maxLength":160},"subtitle":{"type":"string","minLength":1,"maxLength":240},"locale":{"type":"string","enum":["en","es"]}},"additionalProperties":false},"Chart":{"type":"object","properties":{"id":{"description":"chart_…; null with store: false or plan_only.","type":["string","null"]},"object":{"type":"string","const":"chart"},"type":{"anyOf":[{"type":"string","enum":["line","area","bar","bar_horizontal","stacked_bar","pie","donut","scatter","funnel","timeline","kpi","table"]},{"type":"null"}]},"theme":{"type":"string","enum":["light","dark","editorial","electric"]},"locale":{"type":"string","enum":["en","es"]},"chart":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["line","area","bar","bar_horizontal","stacked_bar","pie","donut","scatter","funnel","timeline","kpi","table"]},"title":{"type":"string","description":"States the finding: «The blue dollar rose 4.1% this week»."},"subtitle":{"type":"string"},"x":{"type":"object","properties":{"kind":{"type":"string","enum":["time","category","number"]},"label":{"type":"string"},"unit":{"type":"string"},"granularity":{"type":"string","enum":["hour","day","week","month","year"]}},"required":["kind"],"additionalProperties":false},"y":{"type":"object","properties":{"label":{"type":"string"},"unit":{"type":"string"},"format":{"type":"string","enum":["number","percent","currency"]},"currency":{"type":"string"},"decimals":{"type":"number"},"higher_is_better":{"type":"boolean"}},"additionalProperties":false},"x_measure":{"type":"object","properties":{"label":{"type":"string"},"unit":{"type":"string"},"format":{"type":"string","enum":["number","percent","currency"]},"currency":{"type":"string"},"decimals":{"type":"number"},"higher_is_better":{"type":"boolean"}},"additionalProperties":false},"series":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"role":{"type":"string","enum":["positive","neutral","negative","other"]},"points":{"type":"array","items":{"type":"object","properties":{"x":{"type":["string","number"]},"y":{"type":"number"},"r":{"type":"number"},"label":{"type":"string"},"sources":{"description":"Indexes in `sources`: where this value was published.","type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["x","y"],"additionalProperties":false}}},"required":["name","points"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"end":{"type":"string"},"label":{"type":"string"},"detail":{"type":"string"},"sources":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["date","label"],"additionalProperties":false}},"columns":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"format":{"type":"object","properties":{"label":{"type":"string"},"unit":{"type":"string"},"format":{"type":"string","enum":["number","percent","currency"]},"currency":{"type":"string"},"decimals":{"type":"number"},"higher_is_better":{"type":"boolean"}},"additionalProperties":false}},"required":["key","label"],"additionalProperties":false}},"rows":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","null"]}}},"kpis":{"description":"The key figures above the chart: latest, change, high.","type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"number"},"format":{"type":"object","properties":{"label":{"type":"string"},"unit":{"type":"string"},"format":{"type":"string","enum":["number","percent","currency"]},"currency":{"type":"string"},"decimals":{"type":"number"},"higher_is_better":{"type":"boolean"}},"additionalProperties":false},"change":{"type":"object","properties":{"value":{"type":"number"},"percent":{"type":"boolean"}},"required":["value","percent"],"additionalProperties":false}},"required":["label","value"],"additionalProperties":false}},"annotations":{"type":"array","items":{"type":"object","properties":{"x":{"type":["string","number"]},"y":{"type":"number"},"series":{"type":"string"},"text":{"type":"string"},"kind":{"type":"string","enum":["peak","max","min","last","event"]}},"required":["x","text","kind"],"additionalProperties":false}},"highlight":{"type":"string"},"total":{"type":"number"},"part_of_whole":{"type":"boolean"},"scale":{"type":"string","enum":["linear","log"]},"smoothing":{"description":"Moving average drawn over the raw series, in points.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"attribution":{"type":"string"}},"required":["type","title","x","y","series"],"additionalProperties":false},{"type":"null"}],"description":"What is drawn: series, key figures, annotations, sources. Null with plan_only."},"compatible_types":{"type":"array","items":{"type":"string","enum":["line","area","bar","bar_horizontal","stacked_bar","pie","donut","scatter","funnel","timeline","kpi","table"]},"description":"The chart types this data supports."},"plan":{"anyOf":[{"type":"object","properties":{"recipe":{"type":"string","enum":["coverage","coverage_compare","share_of_voice","tone","tone_compare","outlets","timeline","figure_trend","figure_compare","answers","index_prices","index_scatter","index_availability","index_brands","data","series","people","outlet","stories"],"description":"What was measured: coverage, share_of_voice, tone, outlets, timeline, figure_trend, figure_compare, answers, or index_* from your custom index."},"intent":{"type":"string"},"measure":{"type":"string"},"x_axis":{"type":"string"},"type":{"type":"string","enum":["line","area","bar","bar_horizontal","stacked_bar","pie","donut","scatter","funnel","timeline","kpi","table"]},"part_of_whole":{"type":"boolean"},"confidence":{"type":"number"},"alternatives":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["line","area","bar","bar_horizontal","stacked_bar","pie","donut","scatter","funnel","timeline","kpi","table"]},"probability":{"type":"number"}},"required":["type","probability"],"additionalProperties":false},"description":"Other chart types that fit: switch with PATCH, free."},"topic":{"type":"string"},"entities":{"type":"array","items":{"type":"string"}},"needs":{"type":"object","properties":{"queries":{"type":"array","items":{"type":"string"}},"mode":{"type":"string","enum":["ultra","fast","normal","deep"]},"days":{"type":"number"},"min_points":{"type":"number"},"max_results":{"type":"number"}},"required":["queries","mode","days","min_points","max_results"],"additionalProperties":false,"description":"The data it needs before drawing."}},"required":["recipe","intent","measure","x_axis","type","part_of_whole","confidence","alternatives","topic","entities","needs"],"additionalProperties":false},{"type":"null"}],"description":"From a query: what was measured and why this chart. Null for your own data."},"interpretation":{"anyOf":[{"type":"object","properties":{"label":{"type":"string","description":"What we understood you expect to see: «Finishing positions of the last Formula 1 race»."},"confidence":{"type":"number"},"alternatives":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"probability":{"type":"number"}},"required":["label","probability"],"additionalProperties":false},"description":"Other readings of the query: pass one as `interpretation` to chart it instead."}},"required":["label","confidence","alternatives"],"additionalProperties":false},{"type":"null"}],"description":"From a query in words. Null for your own data, a custom index or a typed question."},"rung":{"anyOf":[{"type":"string","enum":["exact","partial","related","coverage","stories"]},{"type":"null"}],"description":"How close the chart is to what was asked. exact: the data itself, complete and verified; partial: a verified part (the podium); related: another view of the same question (the most mentioned names); coverage: the coverage or the timeline; stories: the top stories. Null for your own data."},"improving":{"type":"boolean","description":"Still looking for what was asked: the stored chart (embed, image) updates itself if it arrives. Poll GET /v1/charts/{id} or use stream: true."},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":["string","null"]},"published_at":{"type":["string","null"]}},"required":["url","title","source","published_at"],"additionalProperties":false}},"embed_url":{"description":"An iframe that adapts to its width, with tooltips. Add ?theme= to change the theme.","type":["string","null"]},"image_url":{"description":"PNG at twice the resolution, for chat, email or slides.","type":["string","null"]},"svg_url":{"type":["string","null"]},"svg":{"description":"The SVG, with include_svg or store: false.","type":["string","null"]},"created_at":{"type":["string","null"]},"expires_at":{"type":["string","null"]},"cached":{"type":"boolean","description":"The same request in the last 10 minutes: the same chart, not billed."},"usage":{"type":"object","properties":{"cost_usd":{"type":"number"},"mode":{"anyOf":[{"type":"string","enum":["ultra","fast","normal","deep","data"]},{"type":"null"}]},"queries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"duration_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["cost_usd","mode","queries","duration_ms"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["id","object","type","theme","locale","chart","compatible_types","plan","interpretation","rung","improving","sources","embed_url","image_url","svg_url","svg","created_at","expires_at","cached","usage","warnings"],"additionalProperties":false},"ChartList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"title":{"type":"string"},"theme":{"type":"string"},"locale":{"type":"string"},"created_at":{"type":"string"},"expires_at":{"type":["string","null"]},"embed_url":{"type":"string"},"image_url":{"type":"string"},"svg_url":{"type":"string"}},"required":["id","type","title","theme","locale","created_at","expires_at","embed_url","image_url","svg_url"],"additionalProperties":false}},"has_more":{"type":"boolean"},"next_before":{"description":"Pass it as `before` for the next page.","type":["string","null"]}},"required":["object","data","has_more","next_before"],"additionalProperties":false}}},"paths":{"/v1/search":{"post":{"summary":"Search the index for one topic, or up to five","description":"When the index has fewer than 3 good matches for a single query, discovery looks for sources beyond it within a time budget (3 s in normal, 8 s in deep; ultra and fast add at most 0.8 s: the open news index and one relevance check, the rest keeps learning in the background): outlets proposed by a topic model and by an open news index, read at the original site with robots.txt respected and judged by the same relevance model; in deep, also the search that those sites declare, with a topic keyword. Discovered results come with `found_in: discovery`; `discovery` says what it did and `incomplete` whether the time ran out. With stream: true, index results arrive first and discovered ones in later partial events. Open news index built from the GDELT Project (gdeltproject.org).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"The result; with stream: true, server-sent events.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}},"text/event-stream":{"schema":{"type":"string","description":"Server-sent events: step, partial, result or error; `data` is JSON."}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/search/site":{"post":{"summary":"Search a live site for a topic","description":"Can take up to a minute: returns a job (202) to poll at /v1/jobs/{id}, or server-sent events with stream: true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteSearchRequest"}}}},"responses":{"200":{"description":"With stream: true, server-sent events.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}},"text/event-stream":{"schema":{"type":"string","description":"Server-sent events: step, partial, result or error; `data` is JSON."}}}},"202":{"description":"The job that was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/jobs/{id}":{"get":{"summary":"Get a job’s status and result","parameters":[{"name":"id","in":"path","required":true,"description":"The job id returned by POST /v1/search/site.","schema":{"type":"string"}}],"responses":{"200":{"description":"The job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/similar":{"post":{"summary":"Find index articles about the same story as a URL","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimilarRequest"}}}},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/contents":{"post":{"summary":"Get metadata and short excerpts for up to 10 URLs","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentsRequest"}}}},"responses":{"200":{"description":"One entry per URL, each with its own status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentsResponse"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/usage":{"get":{"summary":"Get this key’s usage and limits","responses":{"200":{"description":"The usage.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/indexes":{"post":{"summary":"Create a custom index","description":"A custom index is your own list of URLs, searched with the same relevance model as the news index: pass its id as `index` to POST /v1/search. Pay as you go allows 3 indexes and 100 URLs; the Monthly credit plan 50 and 10,000; Enterprise, unlimited.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexRequest"}}}},"responses":{"201":{"description":"The index that was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Index"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`index_limit_reached`: your plan allows no more indexes.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"summary":"List your custom indexes","responses":{"200":{"description":"Your indexes and your plan’s limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexList"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/indexes/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The index id, idx_…","schema":{"type":"string"}}],"get":{"summary":"Get a custom index","responses":{"200":{"description":"The index.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Index"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"summary":"Delete a custom index and its URLs","responses":{"200":{"description":"`{ id, deleted: true }`"},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/indexes/{id}/urls":{"parameters":[{"name":"id","in":"path","required":true,"description":"The index id, idx_…","schema":{"type":"string"}}],"post":{"summary":"Add URLs, a sitemap or a feed","description":"Up to 1,000 URLs per request, and sitemaps or feeds (read every hour: new URLs are added, updated ones re-read). New URLs are read within a minute and every URL is re-read daily, honoring robots.txt and publisher exclusions. URLs beyond your plan’s limit are counted in `over_limit`, with a warning; if none fits, 409 `url_limit_reached`. Billed daily: US$2.00 per 1,000 URLs per month.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexUrlsRequest"}}}},"responses":{"202":{"description":"What was added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexUrlsResponse"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`url_limit_reached`: your plan’s URL limit is full.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"summary":"List the URLs of a custom index","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","ready","failed","blocked"]}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"A page of URLs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexUrlList"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"summary":"Remove URLs or sources","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexUrlsDeleteRequest"}}}},"responses":{"200":{"description":"`{ removed, removed_sources }`"},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/charts":{"post":{"summary":"Create a chart card from a query or your own data","description":"Ask in plain words («blue dollar this week», «standings last Formula 1 race», «elections in Brazil», «Milei vs Bullrich coverage», «news in The Guardian this week», «prices in my catalog» with `index`). It first works out what you expect to see (`interpretation`, with other readings you can ask for), then gets that data: the finishing positions of the latest race, poll or result shares, wins in the season, coverage, tone, outlets, a timeline or the figures the articles publish, verified against the sources. It never fails while there are articles on the topic: if the exact data is not published or takes too long, it shows the closest thing (`rung`: exact, partial, related, coverage, stories) with a warning, and a stored chart keeps `improving` until the exact data arrives. With `stream: true`, server-sent events: `step`, `result` and `improved`. Or send `data` (series, events, or columns and rows) and it picks the chart, sorts, summarizes and titles it. `type` forces one of 12 types while the data allows. From a query it costs its search (the mode it ended in, one per compared name; free if cached) plus the chart add-on; from your data, the data price (see `x-pricing`, per_1000_charts). The same request within 10 minutes returns the same card, free. No articles at all: 422 `insufficient_data`, not billed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartRequest"}}}},"responses":{"200":{"description":"With plan_only, store: false, or the same request within 10 minutes (cached: true). With stream: true, text/event-stream: `step`, `result` (a Chart), `improved` (a Chart) or `error` (a Problem).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Chart"}}}},"201":{"description":"The chart that was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Chart"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`insufficient_data`: no articles about the topic in the period. Not billed.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"summary":"List your charts","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"before","in":"query","required":false,"description":"The next_before of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"A page of charts, newest first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartList"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/charts/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The chart id, chart_…","schema":{"type":"string"}}],"get":{"summary":"Get a chart","responses":{"200":{"description":"The chart.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Chart"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`chart_not_found`: no chart with that id for this key, or it expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"summary":"Change a chart’s type, theme, title or language","description":"Redraws from the same data: free, no new search. `type` must be one of `compatible_types`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartUpdateRequest"}}}},"responses":{"200":{"description":"The updated chart.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Chart"}}}},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"summary":"Delete a chart","description":"Its embed and image stop working.","responses":{"200":{"description":"`{ id, deleted: true }`"},"402":{"description":"Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"default":{"description":"Error (RFC 9457). In English unless the request sends `Accept-Language: es`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/embed/{file}":{"get":{"summary":"A chart’s public embed, image or SVG","description":"`chart_…` is the iframe page (it switches to a compact layout under 480 px and posts `typesearch:chart:resize` with its height); `chart_….png` the image at 2×; `chart_….svg` the SVG. Query: `theme` (light, dark, editorial, electric) and, for png and svg, `size=compact`. No key needed.","security":[],"parameters":[{"name":"file","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"HTML, PNG or SVG."},"404":{"description":"No such chart, or it expired."}}}}}}