API

Telegram API

Telegram has more than 1 billion monthly active users sharing messages, channels, groups, voice notes, bots, and media, making it important for direct distribution, community management, and fast-moving news audiences.

API Reference Version: 1.0.0 7 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 /bot-info

Parameters

Name	Type	Location	Required	Description
username	`string`	query	Yes

Code Examples

curl -X GET "https://api.pressmonitor.ca/bot-info?username=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/bot-info?username=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/bot-info?username=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/bot-info?username=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/bot-info?username=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/bot-info?username=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 /channel-info

Parameters

Name	Type	Location	Required	Description
username	`string`	query	Yes

Code Examples

curl -X GET "https://api.pressmonitor.ca/channel-info?username=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/channel-info?username=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/channel-info?username=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/channel-info?username=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/channel-info?username=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/channel-info?username=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 /get-messages

Parameters

Name	Type	Location	Required	Description
username	`string`	query	Yes
offset	`string`	query	No

Code Examples

curl -X GET "https://api.pressmonitor.ca/get-messages?username=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/get-messages?username=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/get-messages?username=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/get-messages?username=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/get-messages?username=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/get-messages?username=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 /group-info

Parameters

Name	Type	Location	Required	Description
username	`string`	query	Yes

Code Examples

curl -X GET "https://api.pressmonitor.ca/group-info?username=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/group-info?username=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/group-info?username=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/group-info?username=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/group-info?username=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/group-info?username=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 /search

Parameters

Name	Type	Location	Required	Description
keyword	`string`	query	Yes

Code Examples

curl -X GET "https://api.pressmonitor.ca/search?keyword=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/search?keyword=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/search?keyword=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/search?keyword=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/search?keyword=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/search?keyword=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 /search-hashtag

Parameters

Name	Type	Location	Required	Description
hashtag	`string`	query	Yes
offset	`string`	query	No

Code Examples

curl -X GET "https://api.pressmonitor.ca/search-hashtag?hashtag=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/search-hashtag?hashtag=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/search-hashtag?hashtag=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/search-hashtag?hashtag=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/search-hashtag?hashtag=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/search-hashtag?hashtag=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 /user-info

Parameters

Name	Type	Location	Required	Description
username	`string`	query	Yes

Code Examples

curl -X GET "https://api.pressmonitor.ca/user-info?username=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/user-info?username=VALUE", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/user-info?username=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/user-info?username=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/user-info?username=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/user-info?username=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