API

Reddit API

Reddit serves about 121 million daily active users across forums, threads, text posts, links, images, and comments, making it important for community insight, reputation tracking, product feedback, and niche discovery.

API Reference Version: 1.0.0 14 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 /comments-by-username

Comments By Username

Code Examples

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

fetch("https://api.pressmonitor.ca/comments-by-username", {
  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/comments-by-username");
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/comments-by-username", 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/comments-by-username")
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-cursor

Code Examples

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

fetch("https://api.pressmonitor.ca/get-cursor", {
  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-cursor");
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-cursor", 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-cursor")
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 /new-subreddits

New Subreddits

Code Examples

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

fetch("https://api.pressmonitor.ca/new-subreddits", {
  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/new-subreddits");
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/new-subreddits", 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/new-subreddits")
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 /popular-posts

Popular Subreddits

Code Examples

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

fetch("https://api.pressmonitor.ca/popular-subreddits", {
  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/popular-subreddits");
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/popular-subreddits", 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/popular-subreddits")
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 /post-details

Post Details

Parameters

Name	Type	Location	Required	Description
post_url	`string`	query	Yes

Code Examples

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

fetch("https://api.pressmonitor.ca/post-details?post_url=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/post-details?post_url=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/post-details?post_url=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/post-details?post_url=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 /posts-by-subreddit

Posts By Subreddit

Code Examples

curl -X GET "https://api.pressmonitor.ca/posts-by-subreddit" -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/posts-by-subreddit", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/posts-by-subreddit", {
  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/posts-by-subreddit");
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/posts-by-subreddit", 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/posts-by-subreddit")
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 /posts-by-username

Posts By Username

Code Examples

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

fetch("https://api.pressmonitor.ca/posts-by-username", {
  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/posts-by-username");
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/posts-by-username", 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/posts-by-username")
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 /rising-popular-posts

Rising Popular Posts

Code Examples

curl -X GET "https://api.pressmonitor.ca/rising-popular-posts" -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/rising-popular-posts", headers=headers)
print(response.json())

fetch("https://api.pressmonitor.ca/rising-popular-posts", {
  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/rising-popular-posts");
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/rising-popular-posts", 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/rising-popular-posts")
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-posts

Search Posts

Parameters

Name	Type	Location	Required	Description
query	`string`	query	Yes	Search query

Code Examples

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

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

Search Subreddits

Parameters

Name	Type	Location	Required	Description
query	`string`	query	Yes	Search query

Code Examples

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

fetch("https://api.pressmonitor.ca/search-subreddits?query=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-subreddits?query=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-subreddits?query=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-subreddits?query=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 /top-comments-by-username

Top Comments By Username

Code Examples

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

fetch("https://api.pressmonitor.ca/top-comments-by-username", {
  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/top-comments-by-username");
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/top-comments-by-username", 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/top-comments-by-username")
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 /top-popular-posts

Reddit API

Base URL

Authentication

Comments By Username

Code Examples

Responses

Code Examples

Responses

New Subreddits

Code Examples

Responses

Popular Posts

Code Examples

Responses

Popular Subreddits

Code Examples

Responses

Post Details

Parameters

Code Examples

Responses

Posts By Subreddit

Code Examples

Responses

Posts By Username

Code Examples

Responses

Rising Popular Posts

Code Examples

Responses

Search Posts

Parameters

Code Examples

Responses

Search Subreddits

Parameters

Code Examples

Responses

Top Comments By Username

Code Examples

Responses

Top Popular Posts

Code Examples

Responses

Top Posts By Username

Code Examples

Responses