Skip to main content

API: Requesting historical data

Simple instructions on querying historical data.

  1. Supply date_to and date_from fields as API_URL parameters.

  2. date_to and date_from fields must be in YYYY-MM-DD format.

  3. The results are supplied in the data field of the API response.

  4. By default, the results are sorted by their publication date (newest first).

python

import requests  

API_KEY = "YOUR_API_KEY"
API_URL = "https://app.readpartner.com/api-dashboard/api/v1/monitoring"

params = {
"q": "tariffs",
"platforms": "news_outlets,twitter,reddit",
"page": 1,
"date_to": "2026-02-15",
"date_from": "2026-02-10",
}

headers = {
"X-API-Key": API_KEY,
}

resp = requests.get(API_URL, params=params, headers=headers)

payload = resp.json()

for item in payload["data"]:
print(item["source_url"])

Questions? Feel free to reach out to your account manager or via support chat.

Did this answer your question?