Posts list
curl --request POST \
--url https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ad_account_id": "<string>",
"profile_id": "<string>",
"ad_ids": [
"<string>"
],
"limit": 50
}
'import requests
url = "https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list"
payload = {
"ad_account_id": "<string>",
"profile_id": "<string>",
"ad_ids": ["<string>"],
"limit": 50
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ad_account_id: '<string>',
profile_id: '<string>',
ad_ids: ['<string>'],
limit: 50
})
};
fetch('https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'ad_account_id' => '<string>',
'profile_id' => '<string>',
'ad_ids' => [
'<string>'
],
'limit' => 50
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list"
payload := strings.NewReader("{\n \"ad_account_id\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"ad_ids\": [\n \"<string>\"\n ],\n \"limit\": 50\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ad_account_id\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"ad_ids\": [\n \"<string>\"\n ],\n \"limit\": 50\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ad_account_id\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"ad_ids\": [\n \"<string>\"\n ],\n \"limit\": 50\n}"
response = http.request(request)
puts response.read_bodyReddit
Posts list
Posts (ad creatives) on the connected account’s profiles — headline, type, destination, media — or the posts behind specific ads. A Reddit ad is a promoted post; copy and media live on the post and are immutable once created.
CLI: adside reddit posts list
POST
/
v1
/
workspaces
/
{workspaceId}
/
reddit
/
posts
/
list
Posts list
curl --request POST \
--url https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ad_account_id": "<string>",
"profile_id": "<string>",
"ad_ids": [
"<string>"
],
"limit": 50
}
'import requests
url = "https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list"
payload = {
"ad_account_id": "<string>",
"profile_id": "<string>",
"ad_ids": ["<string>"],
"limit": 50
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ad_account_id: '<string>',
profile_id: '<string>',
ad_ids: ['<string>'],
limit: 50
})
};
fetch('https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'ad_account_id' => '<string>',
'profile_id' => '<string>',
'ad_ids' => [
'<string>'
],
'limit' => 50
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list"
payload := strings.NewReader("{\n \"ad_account_id\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"ad_ids\": [\n \"<string>\"\n ],\n \"limit\": 50\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ad_account_id\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"ad_ids\": [\n \"<string>\"\n ],\n \"limit\": 50\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.adside.ai/v1/workspaces/{workspaceId}/reddit/posts/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ad_account_id\": \"<string>\",\n \"profile_id\": \"<string>\",\n \"ad_ids\": [\n \"<string>\"\n ],\n \"limit\": 50\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
A personal API key (adside_pat_…) or a token from adside login. Either carries the permissions of the person it belongs to.
Path Parameters
Minimum string length:
1Body
application/json
Reddit ad account id (a2_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused.
Profile whose posts to list. Omit to use every profile shared with the ad account.
Alternatively, the posts behind these ads.
Pattern:
^\d{6,25}$Required range:
1 <= x <= 200Response
200 - application/json
Success