Press Monitor Wikidata NewsFlow API — Usage Guide

This guide explains how to use the Wikidata NewsFlow API to fetch headlines, briefs, full text, and rich metadata for any Wikidata entity via its wikidata_id (e.g., Q90 for Paris). It mirrors the endpoints and parameters in the attached OpenAPI spec and includes ready-to-run cURL examples.

Base URL

https://api.pressmonitor.com/news-wikidata/v1

Authentication

Send your key and subscription in the Authorization header:

-H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

Format per spec: Bearer secret_key:subscription_id

Common Query Parameters

• wikidata_id (string, required) — e.g., Q42
• country_code (string, optional) — source-country filter (ISO-3166-1 alpha-2, CSV accepted by backend if enabled)
• lang_code (string, optional) — content language filter (ISO-639-1)
• count (int, optional, default=20) — page size
• sort (string, optional: relevance | latest) — ranking mode (publish-time vs semantic)
• search_after (string, optional) — pagination cursor (only with sort=latest)

---

Endpoints (as defined in the spec)

1) GET /news-headlines

What: Recent headlines for a Wikidata entity.
Params: wikidata_id (required), country_code, lang_code, count, sort, search_after
Envelope: EnvelopeHeadlines → { items: NewsHeadlineItem[], credits, next }
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-headlines?wikidata_id=Q90&count=10&sort=latest" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

2) GET /news-briefs

What: Headlines + short AI-generated summaries.
Params: same as /news-headlines
Envelope: EnvelopeBriefs → { items: NewsBriefItem[], credits, next }
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-briefs?wikidata_id=Q90&count=10" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

3) GET /news-fulltext

What: Full article content.
Params: same as /news-headlines
Envelope: EnvelopeFulltext → { items: NewsFulltextItem[], credits, next }
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-fulltext?wikidata_id=Q90&count=5" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

4) GET /news-fulltext-metadata

What: Full article + enriched metadata (Wikidata links, entities, IPTC Media Topics).
Params: same as /news-headlines
Envelope: EnvelopeFulltextMetadata → { items: NewsFulltextMetadataItem[], credits, next }
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-fulltext-metadata?wikidata_id=Q90&count=5" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

5) GET /news-headlines-translated

What: Translated headlines for a Wikidata entity.
Params: wikidata_id (required), target_lang_code (required), country_code, lang_code, count, sort, search_after
Envelope: EnvelopeHeadlinesTranslated
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-headlines-translated?wikidata_id=Q90&target_lang_code=en&count=10" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

6) GET /news-briefs-translated

What: Translated briefs (with tr block for translated fields).
Params: wikidata_id (required), target_lang_code (required), country_code, lang_code, count, sort, search_after
Envelope: EnvelopeBriefsTranslated (items include tr)
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-briefs-translated?wikidata_id=Q90&target_lang_code=en&count=10" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

7) GET /news-fulltext-translated

What: Translated full text (with tr block).
Params: wikidata_id (required), target_lang_code (required), plus optionals above
Envelope: EnvelopeFulltextTranslated (items include tr)
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-fulltext-translated?wikidata_id=Q90&target_lang_code=en&count=5" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

8) GET /news-fulltext-metadata-translated

What: Translated full text + metadata (with tr block).
Params: wikidata_id (required), target_lang_code (required), plus optionals above
Envelope: EnvelopeFulltextMetadataTranslated (items include tr)
Example:

curl -s "https://api.pressmonitor.com/news-wikidata/v1/news-fulltext-metadata-translated?wikidata_id=Q90&target_lang_code=en&count=5" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID"

Pagination & Sorting

• Use count to control page size.
• When sort=latest, the response may return next.search_after. Pass that cursor back with the same sort mode for the next page.
• relevance uses semantic ranking; latest uses publish timestamp.

Response Headers

On success and error, responses may include:
X-Request-ID, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Error Model

Errors follow RFC 7807 (application/problem+json) with fields like title, status, detail.

Best Practices

• Prefer wikidata_id over keywords to avoid entity ambiguity.
• Use headlines for fast polling, briefs for skimming, fulltext for analysis, and fulltext-metadata for downstream NLP.
• For multilingual use cases, call the translated endpoints with target_lang_code and keep the source language via tr.source_lang_code.

---

Support

Docs: https://www.pressmonitor.com/en/docs/news-wikidata-api-mcp

Email: support@pressmonitor.com