curl 'https://api.poddata.ai/v1/targets/example-water/coverage' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/targets/{company}/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/targets/{company}/coverage', 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}/coverage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/targets/{company}/coverage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poddata.ai/v1/targets/{company}/coverage")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/coverage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company": {
"id": "example-water",
"name": "Example Water"
},
"window": {
"from": "2023-11-17",
"to": "2026-11-17"
},
"links": {
"confirmed": 3,
"proposed": 1,
"struck": 0
},
"counted": {
"read": 1,
"due": 0,
"waiting": 0,
"off_here": 0,
"by_request": 0,
"not_read": 0,
"not_built": 0
},
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"family": {
"id": "reviews",
"name": "Reviews"
},
"route": "Public page",
"cadence": "Weekly",
"stands": "read",
"why": null,
"needs": [
"google_place"
],
"links": {
"confirmed": 2,
"proposed": 0
},
"holds": {
"records": 0,
"signals": 412,
"documents": 0,
"from": "2021-03-02",
"to": "2026-11-16"
},
"last_ok": "2026-11-16T09:15:00.000Z",
"last_run": {
"at": "2026-11-17T09:15:00.000Z",
"status": "capped"
},
"pull": {
"captured_at": "2026-11-16T09:15:00.000Z",
"sort": "newest",
"filter": null,
"method": "apify",
"total": 430,
"items": 412,
"held": 412
},
"breaks": []
}
],
"read": {
"asked_at": "2026-11-17T09:00:00.000Z",
"until": "2026-11-18T09:00:00.000Z",
"state": "held",
"queued": 2,
"ran": 1,
"left": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"state": "held",
"why": "Its run for Example Water at 2026-11-17 09:15 UTC stopped at a day's cap: it reads Example Water again after midnight UTC.",
"opens": "2026-11-18T00:00:00.000Z"
}
],
"why": "The read of Example Water asked for at 2026-11-17 09:00 UTC is held: Google Maps reviews and listings, until 2026-11-18 00:00 UTC. 1 of 2 readers have run; come back after midnight UTC, or go on with what has run."
},
"rivals": [
{
"company": {
"id": "example-springs",
"name": "Example Springs"
},
"links": {
"confirmed": 1,
"proposed": 0
},
"sources": [
{
"id": "gdelt",
"stands": "read",
"holds": {
"records": 0,
"signals": 9,
"documents": 0,
"from": "2025-02-11",
"to": "2026-11-12"
}
}
],
"read": {
"asked_at": "2026-11-17T09:00:00.000Z",
"until": "2026-11-18T09:00:00.000Z",
"state": "done",
"queued": 1,
"ran": 1,
"left": [],
"why": "The read of Example Springs asked for at 2026-11-17 09:00 UTC is done: its reader has run since. Go on."
}
}
]
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}What has been read for one of the team's targets, source by source, and what's missing and why
Says what PodData has read for one of your targets, so a page can say how it was built: every source in the catalog and where it stands (read, due, waiting on a link, off_here, by_request, not_read or not_built), what each holds tied to the company over which days, how it was last read, and the known breaks in the window, with the same counted for each confirmed rival. read says whether the read you last asked for is going, done or held by a day’s cap, for the target and each rival, with each reader still to run.
Before: The company is one of your targets (POST /targets), its links and rivals confirmed by a person, and a read asked for with POST /targets/{company}/read.
Next: While read is going, ask again in a few minutes. When it’s held, come back after midnight UTC or go on with what has run; when it’s done, go on: the target’s folder (GET /targets/{company}/folder) and a report (POST /diligence-reports).
Limits: Your own targets only: another company is a 404. A source held by a day’s cap, or past its share of a day’s requests, opens at the next midnight UTC; an ask lapses a day after it was made.
curl 'https://api.poddata.ai/v1/targets/example-water/coverage' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/targets/{company}/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/targets/{company}/coverage', 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}/coverage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/targets/{company}/coverage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poddata.ai/v1/targets/{company}/coverage")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/coverage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"company": {
"id": "example-water",
"name": "Example Water"
},
"window": {
"from": "2023-11-17",
"to": "2026-11-17"
},
"links": {
"confirmed": 3,
"proposed": 1,
"struck": 0
},
"counted": {
"read": 1,
"due": 0,
"waiting": 0,
"off_here": 0,
"by_request": 0,
"not_read": 0,
"not_built": 0
},
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"family": {
"id": "reviews",
"name": "Reviews"
},
"route": "Public page",
"cadence": "Weekly",
"stands": "read",
"why": null,
"needs": [
"google_place"
],
"links": {
"confirmed": 2,
"proposed": 0
},
"holds": {
"records": 0,
"signals": 412,
"documents": 0,
"from": "2021-03-02",
"to": "2026-11-16"
},
"last_ok": "2026-11-16T09:15:00.000Z",
"last_run": {
"at": "2026-11-17T09:15:00.000Z",
"status": "capped"
},
"pull": {
"captured_at": "2026-11-16T09:15:00.000Z",
"sort": "newest",
"filter": null,
"method": "apify",
"total": 430,
"items": 412,
"held": 412
},
"breaks": []
}
],
"read": {
"asked_at": "2026-11-17T09:00:00.000Z",
"until": "2026-11-18T09:00:00.000Z",
"state": "held",
"queued": 2,
"ran": 1,
"left": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"state": "held",
"why": "Its run for Example Water at 2026-11-17 09:15 UTC stopped at a day's cap: it reads Example Water again after midnight UTC.",
"opens": "2026-11-18T00:00:00.000Z"
}
],
"why": "The read of Example Water asked for at 2026-11-17 09:00 UTC is held: Google Maps reviews and listings, until 2026-11-18 00:00 UTC. 1 of 2 readers have run; come back after midnight UTC, or go on with what has run."
},
"rivals": [
{
"company": {
"id": "example-springs",
"name": "Example Springs"
},
"links": {
"confirmed": 1,
"proposed": 0
},
"sources": [
{
"id": "gdelt",
"stands": "read",
"holds": {
"records": 0,
"signals": 9,
"documents": 0,
"from": "2025-02-11",
"to": "2026-11-12"
}
}
],
"read": {
"asked_at": "2026-11-17T09:00:00.000Z",
"until": "2026-11-18T09:00:00.000Z",
"state": "done",
"queued": 1,
"ran": 1,
"left": [],
"why": "The read of Example Springs asked for at 2026-11-17 09:00 UTC is done: its reader has run since. Go on."
}
}
]
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}target_coverage, 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
Query Parameters
Response
Every source in the catalog as it stands for the target, read first, and its confirmed rivals counted