curl -X POST 'https://api.poddata.ai/v1/targets/northwind-dental/read' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"rivals":true}'import requests
url = "https://api.poddata.ai/v1/targets/{company}/read"
payload = { "rivals": True }
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({rivals: true})
};
fetch('https://api.poddata.ai/v1/targets/{company}/read', 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.poddata.ai/v1/targets/{company}/read",
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([
'rivals' => true
]),
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.poddata.ai/v1/targets/{company}/read"
payload := strings.NewReader("{\n \"rivals\": true\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.poddata.ai/v1/targets/{company}/read")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rivals\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/read")
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 \"rivals\": true\n}"
response = http.request(request)
puts response.read_body{
"company": {
"id": "<string>",
"name": "<string>"
},
"asked_at": "<string>",
"until": "<string>",
"again": true,
"queued": [
{
"id": "<string>",
"name": "<string>",
"links": 123
}
],
"waiting": [
{
"id": "<string>",
"name": "<string>",
"needs": [
"<string>"
]
}
],
"asked_today": 123,
"limit": 123,
"rivals": [
{
"company": {
"id": "<string>",
"name": "<string>"
},
"asked_at": "<string>",
"until": "<string>",
"again": true,
"queued": [
{
"id": "<string>",
"name": "<string>",
"links": 123
}
],
"waiting": [
{
"id": "<string>",
"name": "<string>",
"needs": [
"<string>"
]
}
],
"why": "<string>"
}
]
}{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"asked_at": "2026-11-12T16:10:00.000Z",
"until": "2026-11-13T16:10:00.000Z",
"again": false,
"queued": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"links": 3
},
{
"id": "nppes-npi",
"name": "CMS NPPES NPI registry",
"links": 1
}
],
"waiting": [
{
"id": "yelp",
"name": "Yelp",
"needs": [
"yelp_business"
]
}
],
"asked_today": 2,
"limit": 10,
"rivals": [
{
"company": {
"id": "bluebird-dental",
"name": "Bluebird Dental"
},
"asked_at": "2026-11-12T16:10:00.000Z",
"until": "2026-11-13T16:10:00.000Z",
"again": false,
"queued": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"links": 2
}
],
"waiting": [],
"why": null
}
]
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Asks PodData to read one of the team's targets now, and its confirmed rivals with it if asked, ahead of each reader's cadence and under every cap
Asks PodData to read one of your targets now, rather than on each source’s own cadence, which is a day or a week for most. Each source that reads through one of its confirmed links takes it first on its next run, within the quarter hour, under every cap. With {"rivals": true}, each confirmed rival is asked for too. 202 with what was queued (queued, each source with how many links it reads) and what waits on a link no one has confirmed (waiting); 200 with nothing queued when no source here can read it yet, and then nothing is counted.
Before: The company’s links are confirmed, and its rivals’, since a source reads only through a confirmed link.
Next: GET /targets/{company}/coverage says when each source has run. Then GET /targets/{company}/folder lists the files.
Limits: As many a UTC day as the plan’s reads, 1 on Free, 10 on Pro and Pilot, and no limit on Enterprise, each rival counted as one, up to 20 rivals an ask; past it, a 403 with the code plan, and a rival past it comes back with why. An ask made already that no source has run on yet is answered again with again: true, and not counted twice. A source stopped at its own cap shows as capped in coverage, and the ask stays for it until until, a day after it was made.
curl -X POST 'https://api.poddata.ai/v1/targets/northwind-dental/read' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"rivals":true}'import requests
url = "https://api.poddata.ai/v1/targets/{company}/read"
payload = { "rivals": True }
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({rivals: true})
};
fetch('https://api.poddata.ai/v1/targets/{company}/read', 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.poddata.ai/v1/targets/{company}/read",
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([
'rivals' => true
]),
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.poddata.ai/v1/targets/{company}/read"
payload := strings.NewReader("{\n \"rivals\": true\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.poddata.ai/v1/targets/{company}/read")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rivals\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/read")
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 \"rivals\": true\n}"
response = http.request(request)
puts response.read_body{
"company": {
"id": "<string>",
"name": "<string>"
},
"asked_at": "<string>",
"until": "<string>",
"again": true,
"queued": [
{
"id": "<string>",
"name": "<string>",
"links": 123
}
],
"waiting": [
{
"id": "<string>",
"name": "<string>",
"needs": [
"<string>"
]
}
],
"asked_today": 123,
"limit": 123,
"rivals": [
{
"company": {
"id": "<string>",
"name": "<string>"
},
"asked_at": "<string>",
"until": "<string>",
"again": true,
"queued": [
{
"id": "<string>",
"name": "<string>",
"links": 123
}
],
"waiting": [
{
"id": "<string>",
"name": "<string>",
"needs": [
"<string>"
]
}
],
"why": "<string>"
}
]
}{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"asked_at": "2026-11-12T16:10:00.000Z",
"until": "2026-11-13T16:10:00.000Z",
"again": false,
"queued": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"links": 3
},
{
"id": "nppes-npi",
"name": "CMS NPPES NPI registry",
"links": 1
}
],
"waiting": [
{
"id": "yelp",
"name": "Yelp",
"needs": [
"yelp_business"
]
}
],
"asked_today": 2,
"limit": 10,
"rivals": [
{
"company": {
"id": "bluebird-dental",
"name": "Bluebird Dental"
},
"asked_at": "2026-11-12T16:10:00.000Z",
"until": "2026-11-13T16:10:00.000Z",
"again": false,
"queued": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"links": 2
}
],
"waiting": [],
"why": null
}
]
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}read_target, on PodData’s MCP server at https://api.poddata.ai/mcp, does what this route does, with the same key. See The MCP server.Authorizations
Body
Response
Nothing to queue: no reader switched on here reads against a confirmed link of the company, or of its rivals