Press Monitor Wikidata API — Usage Guide

This guide explains how to use the Press Monitor Wikidata API for entity search, property/claim filtering, temporal discovery, and entity retrieval. It covers all endpoints defined in the current OpenAPI spec and includes ready-to-run cURL examples.

Base URL

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

Authentication

Provide your API key in the header:

-H "x-api-key: YOUR_API_KEY"

Rate Limits & Headers (if enabled)

X-RateLimit-Limit — ceiling for your plan
X-RateLimit-Remaining — remaining requests in the current window
X-RateLimit-Reset — UTC epoch when the window resets

Endpoints

1) GET /search/by-label

Search entities by label/title. Params: query_text (required), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/search/by-label?query_text=Paris&lang_code=en&limit=10" -H "x-api-key: YOUR_API_KEY"

2) GET /search/by-description

Search entities by description. Params: query_text (required), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/search/by-description?query_text=capital%20of%20France&lang_code=en&limit=10" -H "x-api-key: YOUR_API_KEY"

3) GET /search/by-claim

Search entities where a property has a particular value. Params: property (P-id, required), value (optional), mode (exact|prefix|fulltext), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/search/by-claim?property=P17&value=Q142&mode=exact&limit=20" -H "x-api-key: YOUR_API_KEY"

4) GET /suggest-entities

Type-ahead style suggestions for entities. Params: query_text (required), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/suggest-entities?query_text=Par&lang_code=en&limit=5" -H "x-api-key: YOUR_API_KEY"

5) GET /search/by-type

Search entities filtered by instance-of/type (P31). Params: type (Q-id, required), query_text (optional), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/search/by-type?type=Q5&query_text=Albert&lang_code=en&limit=10" -H "x-api-key: YOUR_API_KEY"

6) GET /find/by-property

Find entities that contain a given property, optionally with a value/qualifier. Params: property (P-id, required), value (optional), qualifier (P-id), rank (preferred|normal|deprecated), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/find/by-property?property=P31&value=Q5&limit=10" -H "x-api-key: YOUR_API_KEY"

7) GET /search/temporal

Time-aware search over statements within a date range. Params: property (P-id), from (ISO date), to (ISO date), value (optional), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/search/temporal?property=P585&from=2020-01-01&to=2024-12-31&limit=25" -H "x-api-key: YOUR_API_KEY"

8) GET /entities/{id}

Get full entity payload by Q-id. Params: id (path, required), lang_code
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/entities/Q90?lang_code=en" -H "x-api-key: YOUR_API_KEY"

9) GET /entities/{id}/claims

Get flattened/enriched claim statements for an entity. Params: id (path, required), lang_code, limit, offset
Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/entities/Q90/claims?limit=50" -H "x-api-key: YOUR_API_KEY"

10) GET /properties

Get all Wikidata properties with English labels (dictionary of P* → label). Example:

curl -s "https://api.pressmonitor.com/wikidata/v1/properties" -H "x-api-key: YOUR_API_KEY"

Tips & Best Practices

Start broad with /search/by-label and /search/by-description, then narrow using /search/by-claim or /find/by-property.
Use /search/by-type to confine results to a specific instance-of (e.g., Q5 = human).
Paginate with limit/offset; check meta.* blocks for counts and performance metrics.
Cache /properties and frequent /entities/{id} results for better performance.
Prefer mode=exact for precise claim matching; switch to prefix/fulltext to broaden.

Support

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

Email: support@pressmonitor.com