API

Print News Search Direct API

The AI-powered Print Media Monitor provides 360° Global Media Data & Intelligence on Newspapers, magazines, trade publications, and print journalism outlets.

API Reference Version: 1.0.0 4 Endpoints Authentication

Base URL

https://pressmonitor.ca/api

Authentication

All requests require x-api-key and x-subscription-id headers. x-api-key authenticates your account; x-subscription-id selects the subscribed service.

x-api-key: YOUR_API_KEY
x-subscription-id: YOUR_SUB_ID

GET /headlines

Headlines

Parameters

Name	Type	Location	Required	Description
keywords_text	`string`	query	Yes	Keywords text parameter
lang_code	`string`	query	No	Lang code parameter
country_code	`string`	query	No	Country code parameter
count	`integer`	query	No	Count parameter
cursor	`string`	query	No	Cursor parameter
sort	`string`	query	No	Sort order (date or relevance)
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)

Code Examples

curl -X GET \
  "https://pressmonitor.ca/api/headlines?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://pressmonitor.ca/api/headlines?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", headers=headers)
print(response.json())

fetch("https://pressmonitor.ca/api/headlines?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", {
  method: "GET",
  headers: {"x-api-key": "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://pressmonitor.ca/api/headlines?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: 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://pressmonitor.ca/api/headlines?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", nil)
    req.Header.Set("x-api-key", "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://pressmonitor.ca/api/headlines?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE")
req = Net::HTTP::.new(uri)
req["x-api-key"] = "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

Briefs

Parameters

Name	Type	Location	Required	Description
keywords_text	`string`	query	Yes	Keywords text parameter
lang_code	`string`	query	No	Lang code parameter
country_code	`string`	query	No	Country code parameter
count	`integer`	query	No	Count parameter
cursor	`string`	query	No	Cursor parameter
sort	`string`	query	No	Sort order (date or relevance)
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)

Code Examples

curl -X GET \
  "https://pressmonitor.ca/api/briefs?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://pressmonitor.ca/api/briefs?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", headers=headers)
print(response.json())

fetch("https://pressmonitor.ca/api/briefs?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", {
  method: "GET",
  headers: {"x-api-key": "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://pressmonitor.ca/api/briefs?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: 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://pressmonitor.ca/api/briefs?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", nil)
    req.Header.Set("x-api-key", "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://pressmonitor.ca/api/briefs?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE")
req = Net::HTTP::.new(uri)
req["x-api-key"] = "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

Fulltext

Parameters

Name	Type	Location	Required	Description
keywords_text	`string`	query	Yes	Keywords text parameter
lang_code	`string`	query	No	Lang code parameter
country_code	`string`	query	No	Country code parameter
count	`integer`	query	No	Count parameter
cursor	`string`	query	No	Cursor parameter
sort	`string`	query	No	Sort order (date or relevance)
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)

Code Examples

curl -X GET \
  "https://pressmonitor.ca/api/fulltext?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://pressmonitor.ca/api/fulltext?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", headers=headers)
print(response.json())

fetch("https://pressmonitor.ca/api/fulltext?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", {
  method: "GET",
  headers: {"x-api-key": "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://pressmonitor.ca/api/fulltext?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: 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://pressmonitor.ca/api/fulltext?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE", nil)
    req.Header.Set("x-api-key", "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://pressmonitor.ca/api/fulltext?keywords_text=VALUE&lang_code=VALUE&country_code=VALUE&count=VALUE&cursor=VALUE&sort=VALUE&date_from=VALUE&date_to=VALUE")
req = Net::HTTP::.new(uri)
req["x-api-key"] = "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 /clip

Clip

Parameters

Name	Type	Location	Required	Description
id	`string`	query	Yes	Clip/article ID to resolve
ns	`string`	query	Yes	Namespace prefix for multi-tenant index resolution
date	`string`	query	Yes	Date of the clip (YYYY-MM-DD)
host	`string`	query	No	Host name for tenant resolution
ttl	`integer`	query	No	Signed URL time-to-live in seconds

Code Examples

curl -X GET \
  "https://pressmonitor.ca/api/clip?id=VALUE&ns=VALUE&date=VALUE&host=VALUE&ttl=VALUE" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-subscription-id: YOUR_SUB_ID"

import requests

headers = {"x-api-key": "YOUR_API_KEY", "x-subscription-id": "YOUR_SUB_ID"}
response = requests.get("https://pressmonitor.ca/api/clip?id=VALUE&ns=VALUE&date=VALUE&host=VALUE&ttl=VALUE", headers=headers)
print(response.json())

fetch("https://pressmonitor.ca/api/clip?id=VALUE&ns=VALUE&date=VALUE&host=VALUE&ttl=VALUE", {
  method: "GET",
  headers: {"x-api-key": "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://pressmonitor.ca/api/clip?id=VALUE&ns=VALUE&date=VALUE&host=VALUE&ttl=VALUE");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: 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://pressmonitor.ca/api/clip?id=VALUE&ns=VALUE&date=VALUE&host=VALUE&ttl=VALUE", nil)
    req.Header.Set("x-api-key", "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://pressmonitor.ca/api/clip?id=VALUE&ns=VALUE&date=VALUE&host=VALUE&ttl=VALUE")
req = Net::HTTP::.new(uri)
req["x-api-key"] = "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