Press Monitor Global News Search API (1.0.0)

Download OpenAPI specification:

OpenAPI specification for the Press Monitor API, offering multiple dimensions such as news search, alerts, sentiment analysis, executive summaries, and scheduled digests.

news

News Headlines

Returns news headlines with titles and URLs.

Authorizations:

bearerAuth

query Parameters

query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-headlines?query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"url": "http://example.com",
"source": "string",
"lang_code": "string",
"country_code": "string",
"ts": 0
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}

News Briefs

Returns headlines, URLs, and brief AI-generated summaries of stories.

Authorizations:

bearerAuth

query Parameters

query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-briefs?query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"description": "string",
"source": "string",
"url": "http://example.com",
"lang_code": "string",
"country_code": "string",
"images": ["http://example.com"
],
"caption": "string",
"ts": 0
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}

Full Articles

Returns full articles with titles, summaries, URLs, images, and article body.

Authorizations:

bearerAuth

query Parameters

query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-fulltext?query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"description": "string",
"source": "string",
"url": "http://example.com",
"lang_code": "string",
"country_code": "string",
"images": ["http://example.com"
],
"caption": "string",
"ts": 0
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}

Full Articles + Metadata

Returns full articles with enriched metadata such as Wikidata IDs, named entities, and subject codes.

Authorizations:

bearerAuth

query Parameters

query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-fulltext-metadata?query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"description": "string",
"body": "string",
"lang_code": "string",
"country_code": "string",
"source": "string",
"url": "http://example.com",
"images": ["http://example.com"
],
"caption": "string",
"wikidata": { },
"entities": [{ }
],
"mediatopics": ["string"
],
"ts": 0
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}

News Headlines with Translation

Returns news headlines with titles and URLs. Translated into the target language.

Authorizations:

bearerAuth

query Parameters

target_lang_code required	string
query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-headlines-translated?target_lang_code=SOME_STRING_VALUE&query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"url": "http://example.com",
"source": "string",
"lang_code": "string",
"country_code": "string",
"ts": 0
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}

News Briefs with Translation

Returns headlines, URLs, and brief AI-generated summaries of stories. Translated into the target language.

Authorizations:

bearerAuth

query Parameters

target_lang_code required	string
query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-briefs-translated?target_lang_code=SOME_STRING_VALUE&query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"description": "string",
"source": "string",
"url": "http://example.com",
"lang_code": "string",
"country_code": "string",
"images": ["http://example.com"
],
"caption": "string",
"ts": 0,
"tr": {"title": "string",
"description": "string",
"caption": "string",
"body": "string",
"source_lang_code": "string",
"target_lang_code": "string"
}
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}

Full Articles with Translation

Returns full articles with titles, summaries, URLs, images, and article body. Translated into the target language.

Authorizations:

bearerAuth

query Parameters

target_lang_code required	string
query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-fulltext-translated?target_lang_code=SOME_STRING_VALUE&query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"description": "string",
"source": "string",
"url": "http://example.com",
"lang_code": "string",
"country_code": "string",
"images": ["http://example.com"
],
"caption": "string",
"ts": 0,
"tr": {"title": "string",
"description": "string",
"caption": "string",
"body": "string",
"source_lang_code": "string",
"target_lang_code": "string"
}
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}

Full Articles + Metadata with Translation

Returns full articles with enriched metadata such as Wikidata IDs, named entities, and subject codes. Translated into the target language.

Authorizations:

bearerAuth

query Parameters

target_lang_code required	string
query_text required	string
country_code	string
lang_code	string
search_after	string Opaque pagination cursor used only with `sort=latest` (publish-time sort).
count	integer Default: 20
sort	string Enum: "relevance" "latest" Ranking mode: latest by publish time (default) or relevance.

Responses

Request samples

cURL
Python (requests)
Node (fetch/https)
Java (OkHttp)
PHP (cURL)

curl --request GET \
  --url 'https://api.pressmonitor.com/news/v1/news-fulltext-metadata-translated?target_lang_code=SOME_STRING_VALUE&query_text=SOME_STRING_VALUE&country_code=SOME_STRING_VALUE&lang_code=SOME_STRING_VALUE&search_after=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&sort=SOME_STRING_VALUE'

Response samples

Content type

application/json

{"items": [{"id": "string",
"title": "string",
"description": "string",
"body": "string",
"lang_code": "string",
"country_code": "string",
"source": "string",
"url": "http://example.com",
"images": ["http://example.com"
],
"caption": "string",
"wikidata": { },
"entities": [{ }
],
"mediatopics": ["string"
],
"ts": 0,
"tr": {"title": "string",
"description": "string",
"caption": "string",
"body": "string",
"source_lang_code": "string",
"target_lang_code": "string"
}
}
],
"credits": {"rate": 0,
"quantity": 0,
"total": 0,
"request_id": "string"
},
"next": {"search_after": "string",
"count": 0,
"sort": "relevance"
}
}