Input schema (JSON)
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "What you're looking for, in any language. Matches by meaning and by keyword (hybrid) over the last 7 days unless since is given; results carry a relevance score."
},
"kind": {
"type": "string",
"description": "Comma-separated: article, press_release, official, community, research, sponsored"
},
"lang": {
"type": "string",
"description": "Comma-separated ISO 639-1 codes, e.g. \"en,es\""
},
"sort": {
"enum": [
"newest",
"hot",
"positive",
"negative"
],
"type": "string",
"default": "newest",
"description": "hot: most widely covered stories of the last 48h, one per story; positive/negative: most positive/negative tone first (last 24h unless since is given)"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 500,
"minimum": 1
},
"match": {
"enum": [
"hybrid",
"keyword",
"semantic"
],
"type": "string",
"default": "hybrid",
"description": "keyword: exact words only; semantic: meaning only (cross-language)"
},
"since": {
"type": "string",
"description": "Only items published at/after this: RFC 3339, a date, or an age like \"6h\", \"2d\""
},
"topic": {
"type": "string",
"description": "Comma-separated topics, e.g. \"space,science\""
},
"until": {
"type": "string",
"description": "Only items published at/before this"
},
"before": {
"type": "string",
"description": "Paging cursor from a previous result's next link"
},
"entity": {
"type": "string",
"description": "Comma-separated Wikidata ids (from find_entities), e.g. \"Q312\""
},
"format": {
"enum": [
"md",
"lines",
"ndjson",
"json"
],
"type": "string",
"default": "md",
"description": "md: readable with summaries; lines: tab-separated, fewest tokens; ndjson/json: full records"
},
"source": {
"type": "string",
"description": "Comma-separated source ids (see list_sources) or publisher domains"
},
"country": {
"type": "string",
"description": "Comma-separated ISO 3166-1 alpha-2 codes of the publisher's country, e.g. \"US,GB\""
},
"category": {
"type": "string",
"description": "Comma-separated IPTC top-level categories: arts-culture-entertainment, conflict-war, crime-law, disaster-accident, economy-business, education, environment, health, human-interest, labour, lifestyle-leisure, politics, religion, science-technology, society, sport, weather"
},
"collapse": {
"enum": [
"story"
],
"type": "string",
"description": "One item per story (best representative); related = other reports of it"
},
"tone_max": {
"type": "number",
"maximum": 1,
"minimum": -1
},
"tone_min": {
"type": "number",
"maximum": 1,
"minimum": -1,
"description": "Only items with tone ≥ this (-1 most negative … 1 most positive)"
},
"political": {
"type": "boolean",
"description": "true: political stories only (political score ≥ 0.5); false: non-political only"
},
"sentiment": {
"type": "string",
"description": "Comma-separated: negative, neutral, positive"
},
"sponsored": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Paid press releases are labeled; exclude to omit them"
}
},
"additionalProperties": false
}