API

Online News Search Direct API

Online news includes reporting published by digital-native outlets, newspapers, broadcasters, wire services, and magazines on the web. It is important for reputation, market signals, policy developments, and fast-moving public information.

API Reference Version: 1.0.0 3 Endpoints Authentication

Base URL

https://api.pressmonitor.ca

Authentication

All requests use Bearer token authentication. Add the Authorization header to every call.

Authorization: Bearer YOUR_API_KEY
x-subscription-id: YOUR_SUB_ID

GET /headlines

Get News Headlines

Parameters

Name	Type	Location	Required	Description
keywords_text	`string`	query	Yes	Primary keyword query used for direct news retrieval
lang_code	`string`	query	No	Filter by language code (ISO 639-1)
country_code	`string`	query	No	Filter by country code (ISO 3166-1 alpha-2)
count	`integer`	query	No	Number of results to return
cursor	`string`	query	No	Pagination cursor for next page
date_from	`string`	query	No	Start date for news (YYYY-MM-DD format)
date_to	`string`	query	No	End date for news (YYYY-MM-DD format)
sort	`string`	query	No	latest\|relevance(default)

Code Examples

curl -X GET "https://api.pressmonitor.ca/headlines?keywords_text=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://api.pressmonitor.ca/headlines?keywords_text=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/headlines?keywords_text=VALUE", {
  method: "GET",
  headers: {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
})
  .then(r => r.json())
  .then(console.log);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.pressmonitor.ca/headlines?keywords_text=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY", "x-subscription-id: YOUR_SUB_ID"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.pressmonitor.ca/headlines?keywords_text=VALUE", nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("x-subscription-id", "YOUR_SUB_ID")
    resp, _ := http.DefaultClient.Do(req)
    body, _ := io.ReadAll(resp.Body)
    resp.Body.Close()
    fmt.Println(string(body))
}

require 'net/http'

uri = URI("https://api.pressmonitor.ca/headlines?keywords_text=VALUE")
req = Net::HTTP::.new(uri)
req["Authorization"] = "Bearer YOUR_API_KEY"
req["x-subscription-id"] = "YOUR_SUB_ID"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

Responses

200 Success

GET /briefs

Get News Briefs

Parameters

Name	Type	Location	Required	Description
keywords_text	`string`	query	Yes	Primary keyword query used for direct news retrieval
lang_code	`string`	query	No	Filter by language code (ISO 639-1)
country_code	`string`	query	No	Filter by country code (ISO 3166-1 alpha-2)
count	`integer`	query	No	Number of results to return
cursor	`string`	query	No	Pagination cursor for next page
date_from	`string`	query	No	Start date for news (YYYY-MM-DD format)
date_to	`string`	query	No	End date for news (YYYY-MM-DD format)
sort	`string`	query	No	latest\|relevance(default)

Code Examples

curl -X GET "https://api.pressmonitor.ca/briefs?keywords_text=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://api.pressmonitor.ca/briefs?keywords_text=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/briefs?keywords_text=VALUE", {
  method: "GET",
  headers: {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
})
  .then(r => r.json())
  .then(console.log);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.pressmonitor.ca/briefs?keywords_text=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY", "x-subscription-id: YOUR_SUB_ID"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.pressmonitor.ca/briefs?keywords_text=VALUE", nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("x-subscription-id", "YOUR_SUB_ID")
    resp, _ := http.DefaultClient.Do(req)
    body, _ := io.ReadAll(resp.Body)
    resp.Body.Close()
    fmt.Println(string(body))
}

require 'net/http'

uri = URI("https://api.pressmonitor.ca/briefs?keywords_text=VALUE")
req = Net::HTTP::.new(uri)
req["Authorization"] = "Bearer YOUR_API_KEY"
req["x-subscription-id"] = "YOUR_SUB_ID"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

Responses

200 Success

GET /fulltext

Get Full-Text News

Parameters

Name	Type	Location	Required	Description
keywords_text	`string`	query	Yes	Primary keyword query used for direct news retrieval
lang_code	`string`	query	No	Filter by language code (ISO 639-1)
country_code	`string`	query	No	Filter by country code (ISO 3166-1 alpha-2)
count	`integer`	query	No	Number of results to return
cursor	`string`	query	No	Pagination cursor for next page
date_from	`string`	query	No	Start date for news (YYYY-MM-DD format)
date_to	`string`	query	No	End date for news (YYYY-MM-DD format)
sort	`string`	query	No	latest\|relevance(default)

Code Examples

curl -X GET "https://api.pressmonitor.ca/fulltext?keywords_text=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://api.pressmonitor.ca/fulltext?keywords_text=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/fulltext?keywords_text=VALUE", {
  method: "GET",
  headers: {"Authorization": "Bearer YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
})
  .then(r => r.json())
  .then(console.log);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.pressmonitor.ca/fulltext?keywords_text=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY", "x-subscription-id: YOUR_SUB_ID"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.pressmonitor.ca/fulltext?keywords_text=VALUE", nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("x-subscription-id", "YOUR_SUB_ID")
    resp, _ := http.DefaultClient.Do(req)
    body, _ := io.ReadAll(resp.Body)
    resp.Body.Close()
    fmt.Println(string(body))
}

require 'net/http'

uri = URI("https://api.pressmonitor.ca/fulltext?keywords_text=VALUE")
req = Net::HTTP::.new(uri)
req["Authorization"] = "Bearer YOUR_API_KEY"
req["x-subscription-id"] = "YOUR_SUB_ID"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

Responses

200 Success