API

Harmonized System News API

The Harmonized System is the global customs classification used by more than 200 administrations and organized into about 5,000 commodity groups. It is important for tariffs, trade compliance, sourcing, and import-export analysis.

API Reference Version: 1.0.0 3 Endpoints Authentication

Base URL

https://pressmonitor.fr/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

Get News Headlines

Parameters

Name	Type	Location	Required	Description
code	`string`	query	Yes	Entity code (e.g., ticker symbol, industry code)
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 (alternative to search_after)
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.fr/api/headlines?code=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.fr/api/headlines?code=VALUE", headers=headers)
print(response.json())

fetch("https://pressmonitor.fr/api/headlines?code=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.fr/api/headlines?code=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.fr/api/headlines?code=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.fr/api/headlines?code=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

Get News Briefs

Parameters

Name	Type	Location	Required	Description
code	`string`	query	Yes	Entity code (e.g., ticker symbol, industry code)
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 (alternative to search_after)
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.fr/api/briefs?code=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.fr/api/briefs?code=VALUE", headers=headers)
print(response.json())

fetch("https://pressmonitor.fr/api/briefs?code=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.fr/api/briefs?code=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.fr/api/briefs?code=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.fr/api/briefs?code=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

Get Full-Text News

Parameters

Name	Type	Location	Required	Description
code	`string`	query	Yes	Entity code (e.g., ticker symbol, industry code)
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 (alternative to search_after)
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.fr/api/fulltext?code=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.fr/api/fulltext?code=VALUE", headers=headers)
print(response.json())

fetch("https://pressmonitor.fr/api/fulltext?code=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.fr/api/fulltext?code=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.fr/api/fulltext?code=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.fr/api/fulltext?code=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