{"openapi":"3.1.0","info":{"title":"Echolot API","version":"1.0.0","description":"Echolot's own derived data — 12-language press intelligence, trends per country, food and horoscope. Same data as the MCP server and the RSS feeds.","contact":{"url":"https://echolotnews.com"}},"servers":[{"url":"https://api.echolotnews.com"},{"url":"https://echolotnews.com"}],"tags":[{"name":"signals","description":"Business questions answered from our own derived data: how much is X discussed and where, what goes together with X, and what the audience wants that the press does not cover. Press, X (media/political accounts), Reddit and YouTube transcripts, matched to the same entity everywhere."},{"name":"trends","description":"Trending signals — our own derived data per country: press corpus velocity, social engines, Google Trends, Wikipedia, Google News, trend matrix, attention gaps."},{"name":"news","description":"Stories, sections, the daily edition, search, sources, economy. Our own output only: summaries, metadata and links — never third-party article bodies."},{"name":"entities","description":"People, organisations and places (Wikidata QIDs) in the 12-language press."},{"name":"food","description":"Menus and recipes in 12 editions; EU-14 allergens (LLM ∪ deterministic dictionary, with evidence). CC BY-SA recipes carry source + licence — attribute them."},{"name":"horoscope","description":"Daily, weekly and monthly horoscopes grounded in the computed sky (JPL DE421). Entertainment, not advice."},{"name":"context","description":"Context signals (weather)."}],"paths":{"/v1/horoscope/day":{"get":{"summary":"Daily horoscope + the computed sky of the day","tags":["horoscope"],"parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today","schema":{"type":"string"}},{"name":"sign","in":"query","required":false,"description":"Zodiac sign (aries … pisces); omit for all 12.","schema":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces"]}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_horoscope_day","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/horoszkop?idoszak=nap","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/horoscope/week":{"get":{"summary":"Weekly horoscope + the computed sky events of the ISO week","tags":["horoscope"],"parameters":[{"name":"week","in":"query","required":false,"description":"YYYY-Www, default the current week","schema":{"type":"string"}},{"name":"sign","in":"query","required":false,"description":"Zodiac sign (aries … pisces); omit for all 12.","schema":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces"]}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_horoscope_week","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/horoszkop?idoszak=het","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/horoscope/month":{"get":{"summary":"Monthly horoscope + the computed sky events of the month","tags":["horoscope"],"parameters":[{"name":"month","in":"query","required":false,"description":"YYYY-MM, default the current month","schema":{"type":"string"}},{"name":"sign","in":"query","required":false,"description":"Zodiac sign (aries … pisces); omit for all 12.","schema":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces"]}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_horoscope_month","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/horoszkop?idoszak=honap","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/sky":{"get":{"summary":"The raw computed sky (JPL DE421): positions, retrogrades, Moon, aspects","tags":["horoscope"],"parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today","schema":{"type":"string"}}],"operationId":"v1_v1_sky","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/food/menu":{"get":{"summary":"The day's menu (allergen-safe: LLM labels ∪ deterministic dictionary)","tags":["food"],"parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today","schema":{"type":"string"}},{"name":"diet","in":"query","required":false,"description":"","schema":{"type":"string","enum":["omni","vegetarian","pescetarian","vegan","lowcal"],"default":"omni"}},{"name":"allergens","in":"query","required":false,"description":"Comma list of EU-14 keys to EXCLUDE: gluten, lactose, egg, nuts, peanuts, soy, sesame, celery, mustard, fish, crustaceans, molluscs, sulphites, lupin","schema":{"type":"string"}},{"name":"cuisines","in":"query","required":false,"description":"Comma list of preferred cuisines","schema":{"type":"string"}},{"name":"meals","in":"query","required":false,"description":"3 or 5 meals a day","schema":{"type":"integer","enum":[3,5],"default":5}},{"name":"insulin_resistance","in":"query","required":false,"description":"Drop dishes with added sugar","schema":{"type":"boolean","default":false}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_food_menu","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/receptek","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/food/week":{"get":{"summary":"7-day menu (weekdays simpler, public holidays special)","tags":["food"],"parameters":[{"name":"week","in":"query","required":false,"description":"YYYY-Www, default the current week","schema":{"type":"string"}},{"name":"diet","in":"query","required":false,"description":"","schema":{"type":"string","enum":["omni","vegetarian","pescetarian","vegan","lowcal"],"default":"omni"}},{"name":"allergens","in":"query","required":false,"description":"Comma list of EU-14 keys to EXCLUDE: gluten, lactose, egg, nuts, peanuts, soy, sesame, celery, mustard, fish, crustaceans, molluscs, sulphites, lupin","schema":{"type":"string"}},{"name":"cuisines","in":"query","required":false,"description":"Comma list of preferred cuisines","schema":{"type":"string"}},{"name":"meals","in":"query","required":false,"description":"3 or 5 meals a day","schema":{"type":"integer","enum":[3,5],"default":5}},{"name":"insulin_resistance","in":"query","required":false,"description":"Drop dishes with added sugar","schema":{"type":"boolean","default":false}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_food_week","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/food/shopping-list":{"get":{"summary":"Shopping list for a week's menu, by shop department","tags":["food"],"parameters":[{"name":"week","in":"query","required":false,"description":"YYYY-Www, default the current week","schema":{"type":"string"}},{"name":"diet","in":"query","required":false,"description":"","schema":{"type":"string","enum":["omni","vegetarian","pescetarian","vegan","lowcal"],"default":"omni"}},{"name":"allergens","in":"query","required":false,"description":"Comma list of EU-14 keys to EXCLUDE: gluten, lactose, egg, nuts, peanuts, soy, sesame, celery, mustard, fish, crustaceans, molluscs, sulphites, lupin","schema":{"type":"string"}},{"name":"cuisines","in":"query","required":false,"description":"Comma list of preferred cuisines","schema":{"type":"string"}},{"name":"meals","in":"query","required":false,"description":"3 or 5 meals a day","schema":{"type":"integer","enum":[3,5],"default":5}},{"name":"insulin_resistance","in":"query","required":false,"description":"Drop dishes with added sugar","schema":{"type":"boolean","default":false}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_food_shopping-list","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/food/recipes/{id}":{"get":{"summary":"One recipe: ingredients, steps, allergens + evidence, source and CC BY-SA licence (attribution required)","tags":["food"],"parameters":[{"name":"id","in":"path","required":true,"description":"","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_food_recipes_id","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/food/recipes":{"get":{"summary":"Search recipes by title/description","tags":["food"],"parameters":[{"name":"q","in":"query","required":true,"description":"Search text","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_food_recipes","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/trends/corpus":{"get":{"summary":"What the PRESS is accelerating on (our 12-language corpus): entities with velocity","tags":["trends"],"parameters":[{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":15}},{"name":"language","in":"query","required":false,"description":"Article language filter","schema":{"type":"string"}},{"name":"sphere","in":"query","required":false,"description":"","schema":{"type":"string"}}],"operationId":"v1_v1_trends_corpus","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/trends/social":{"get":{"summary":"Social trending engines: Reddit, X or YouTube transcripts","tags":["trends"],"parameters":[{"name":"source","in":"query","required":true,"description":"","schema":{"type":"string","enum":["reddit","x","yt_transcripts"]}},{"name":"language","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":15}}],"operationId":"v1_v1_trends_social","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/trends/google":{"get":{"summary":"Google Trends 'trending now' search signal per country","tags":["trends"],"parameters":[{"name":"geo","in":"query","required":false,"description":"Country code, e.g. HU, DE, GB, FR, PL, IT, ES, UA (US for Google News)","schema":{"type":"string"}},{"name":"hours","in":"query","required":false,"description":"","schema":{"type":"integer","default":24}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":15}},{"name":"day","in":"query","required":false,"description":"Archive: YYYY-MM-DD = the first successful fetch of that UTC day; 'list' = available days. Empty = live (cached).","schema":{"type":"string"}}],"operationId":"v1_v1_trends_google","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/trends/wikipedia":{"get":{"summary":"Wikipedia pageview top list per language edition","tags":["trends"],"parameters":[{"name":"geo","in":"query","required":false,"description":"Wikipedia edition, e.g. en, hu, de","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":15}},{"name":"day","in":"query","required":false,"description":"Archive: YYYY-MM-DD = the first successful fetch of that UTC day; 'list' = available days. Empty = live (cached).","schema":{"type":"string"}}],"operationId":"v1_v1_trends_wikipedia","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/trends/news":{"get":{"summary":"Google News top stories per country","tags":["trends"],"parameters":[{"name":"geo","in":"query","required":false,"description":"Country code, e.g. HU, DE, GB, FR, PL, IT, ES, UA (US for Google News)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":15}},{"name":"day","in":"query","required":false,"description":"Archive: YYYY-MM-DD = the first successful fetch of that UTC day; 'list' = available days. Empty = live (cached).","schema":{"type":"string"}}],"operationId":"v1_v1_trends_news","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/trends/matrix":{"get":{"summary":"Trend matrix per country: Google Trends × Wikipedia × Google News × our press corpus — consensus / blind spot / echo cells","tags":["trends"],"parameters":[{"name":"geo","in":"query","required":false,"description":"Country code, e.g. HU, DE, GB, FR, PL, IT, ES, UA (US for Google News)","schema":{"type":"string"}},{"name":"day","in":"query","required":false,"description":"Archive: YYYY-MM-DD = the first successful fetch of that UTC day; 'list' = available days. Empty = live (cached).","schema":{"type":"string"}}],"operationId":"v1_v1_trends_matrix","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/trends/attention-gap":{"get":{"summary":"Attention gaps: what people search for that the press barely covers, per country","tags":["trends"],"parameters":[{"name":"geo","in":"query","required":true,"description":"","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":10}},{"name":"min_gap","in":"query","required":false,"description":"","schema":{"type":"integer","default":30}}],"operationId":"v1_v1_trends_attention-gap","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/signals/mentions":{"get":{"summary":"How much is X talked about — per corpus: press, X (elite discourse), Reddit, YouTube transcripts; same entity matching everywhere","tags":["signals"],"parameters":[{"name":"q","in":"query","required":true,"description":"Keyword, brand, person or Wikidata QID (Q…)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":7}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"niche","in":"query","required":false,"description":"Optional niche (e.g. gazdasagi_elemzes, tortenelem): restricts YouTube to the niche's reference channels and Reddit to its communities","schema":{"type":"string"}}],"operationId":"v1_v1_signals_mentions","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/signals/cooccurrence":{"get":{"summary":"What goes together with X — words over-represented in the documents about X, in the press, on X, on Reddit or in YouTube transcripts (lift vs the same corpus and window)","tags":["signals"],"parameters":[{"name":"q","in":"query","required":true,"description":"Keyword, brand, person or Wikidata QID (Q…)","schema":{"type":"string"}},{"name":"source","in":"query","required":false,"description":"","schema":{"type":"string","enum":["press","x","reddit","yt"],"default":"press"}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":7}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"niche","in":"query","required":false,"description":"Optional niche (e.g. gazdasagi_elemzes, tortenelem): restricts YouTube to the niche's reference channels and Reddit to its communities","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":20}}],"operationId":"v1_v1_signals_cooccurrence","security":[{"ApiKey":[]}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/signals/demand":{"get":{"summary":"Where and how much does the audience care about X: Wikipedia pageviews, Google Trends, Reddit and YouTube mentions — against press coverage","tags":["signals"],"parameters":[{"name":"q","in":"query","required":true,"description":"Keyword, brand, person or Wikidata QID (Q…)","schema":{"type":"string"}},{"name":"geo","in":"query","required":false,"description":"Country code for search demand, e.g. HU, DE","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":7}}],"operationId":"v1_v1_signals_demand","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/signals/gap":{"get":{"summary":"Attention gaps per country: what the audience searches, discusses on Reddit or watches on YouTube, but the press barely covers","tags":["signals"],"parameters":[{"name":"geo","in":"query","required":true,"description":"","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":15}},{"name":"min_gap","in":"query","required":false,"description":"","schema":{"type":"integer","default":30}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":7}}],"operationId":"v1_v1_signals_gap","security":[{"ApiKey":[]}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/stories":{"get":{"summary":"Top story clusters of an edition (our summaries + metadata + links; QID, sphere and framing fields)","tags":["news"],"parameters":[{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"sphere","in":"query","required":false,"description":"Filter to one sphere","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":50}}],"operationId":"v1_v1_stories","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/stories/{id}":{"get":{"summary":"One story: summary, sources, bias distribution, languages, international coverage (metadata + links only)","tags":["news"],"parameters":[{"name":"id","in":"path","required":true,"description":"","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_stories_id","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/sztori/{id}","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/sections/{section}":{"get":{"summary":"A section feed of an edition (tech, economy, sport, …)","tags":["news"],"parameters":[{"name":"section","in":"path","required":true,"description":"","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":40}}],"operationId":"v1_v1_sections_section","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/rovat/{section}","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/edition/daily":{"get":{"summary":"The daily edition (Lapszám) — the day's brief","tags":["news"],"parameters":[{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"limit","in":"query","required":false,"description":"Number of days","schema":{"type":"integer","default":7}}],"operationId":"v1_v1_edition_daily","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/nap","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/search":{"get":{"summary":"Search the 12-language press corpus (metadata + links; no article bodies)","tags":["news"],"parameters":[{"name":"q","in":"query","required":true,"description":"","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":3}},{"name":"language","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"sphere","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":20}}],"operationId":"v1_v1_search","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/kereses","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/entities/top":{"get":{"summary":"Top named entities in the news flow with aggregate sentiment","tags":["entities"],"parameters":[{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":7}},{"name":"type","in":"query","required":false,"description":"","schema":{"type":"string","enum":["person","org","place"]}},{"name":"language","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":30}}],"operationId":"v1_v1_entities_top","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/entities/{qid}":{"get":{"summary":"How a person/org/place is covered: spheres, sources, sentiment, narrative role","tags":["entities"],"parameters":[{"name":"qid","in":"path","required":true,"description":"Wikidata QID (Q…) or a name","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":30}}],"operationId":"v1_v1_entities_qid","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/entities/{qid}/trend":{"get":{"summary":"Mention time series + trend signal for one entity","tags":["entities"],"parameters":[{"name":"qid","in":"path","required":true,"description":"","schema":{"type":"string"}},{"name":"window","in":"query","required":false,"description":"","schema":{"type":"string","default":"12w"}}],"operationId":"v1_v1_entities_qid_trend","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/entities/{qid}/stories":{"get":{"summary":"Stories about one entity across all 12 editions","tags":["entities"],"parameters":[{"name":"qid","in":"path","required":true,"description":"","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":50}}],"operationId":"v1_v1_entities_qid_stories","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/entitas/{qid}","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/sources":{"get":{"summary":"The source catalogue (written press)","tags":["news"],"parameters":[{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"category","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","default":60}},{"name":"offset","in":"query","required":false,"description":"","schema":{"type":"integer","default":0}}],"operationId":"v1_v1_sources","security":[{"ApiKey":[]},{}],"x-rss-equivalent":"/rss/katalogus","responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/economy":{"get":{"summary":"Economy: the day's macro block of an edition (stored) + the economy section's stories","tags":["news"],"parameters":[{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}},{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today","schema":{"type":"string"}}],"operationId":"v1_v1_economy","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/v1/weather":{"get":{"summary":"Weather context for a point + fire-danger index (Open-Meteo)","tags":["context"],"parameters":[{"name":"lat","in":"query","required":false,"description":"","schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"description":"","schema":{"type":"number"}},{"name":"place","in":"query","required":false,"description":"Place name instead of lat/lon","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"","schema":{"type":"integer","default":7}},{"name":"lang","in":"query","required":false,"description":"Edition language (12 editions). Default: en.","schema":{"type":"string","enum":["hu","en","de","es","zh","fr","pl","ru","uk","it","el","tr"],"default":"en"}}],"operationId":"v1_v1_weather","security":[{"ApiKey":[]},{}],"responses":{"200":{"description":"{ok: true, data, served_at, generated, api}"},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"responses":{"Error":{"description":"{ok: false, error: {code, message}}","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}