curl 'https://api.poddata.ai/v1/targets/northwind-dental/folder' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/targets/{company}/folder"
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}/folder', 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}/folder",
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}/folder"
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}/folder")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/folder")
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": "northwind-dental",
"name": "Northwind Dental"
},
"asked_at": "2026-11-14T09:00:00.000Z",
"window": {
"from": "2023-11-14",
"to": "2026-11-14"
},
"counted": {
"read": 9,
"due": 1,
"waiting": 4,
"off_here": 2,
"by_request": 3,
"not_read": 6,
"not_built": 40
},
"parts": [
{
"role": "target",
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"family": {
"id": "reviews",
"name": "Reviews"
},
"stands": "read",
"why": null,
"last_ok": "2026-11-14T06:20:00.000Z",
"records": [],
"signals": [
{
"kind": "review",
"count": 412,
"from": "2024-02-11",
"to": "2026-11-09",
"file": null,
"rows": "/v1/companies/northwind-dental/signals?source=google-maps&kind=review",
"held": "A review site's file isn't handed on yet: read its rows as JSON."
}
],
"documents": {
"count": 0,
"from": null,
"to": null
},
"pages": null
},
{
"id": "nppes-npi",
"name": "CMS NPPES NPI registry",
"family": {
"id": "health",
"name": "Health"
},
"stands": "read",
"why": null,
"last_ok": "2026-11-14T04:02:00.000Z",
"records": [
{
"kind": "organization",
"count": 3,
"from": "2025-06-18",
"to": "2026-10-02",
"file": "/v1/companies/northwind-dental/records?source=nppes-npi&kind=organization&format=csv",
"rows": "/v1/companies/northwind-dental/records?source=nppes-npi&kind=organization",
"held": null
}
],
"signals": [],
"documents": {
"count": 0,
"from": null,
"to": null
},
"pages": null
}
],
"documents": {
"count": 0,
"file": "/v1/documents?company=northwind-dental&format=csv",
"rows": "/v1/documents?company=northwind-dental"
}
},
{
"role": "rival",
"company": {
"id": "bluebird-dental",
"name": "Bluebird Dental"
},
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"family": {
"id": "reviews",
"name": "Reviews"
},
"stands": null,
"why": null,
"last_ok": "2026-11-14T06:24:00.000Z",
"records": [],
"signals": [
{
"kind": "review",
"count": 268,
"from": "2024-02-11",
"to": "2026-11-09",
"file": null,
"rows": "/v1/companies/bluebird-dental/signals?source=google-maps&kind=review",
"held": "A review site's file isn't handed on yet: read its rows as JSON."
}
],
"documents": {
"count": 0,
"from": null,
"to": null
},
"pages": null
}
],
"documents": {
"count": 0,
"file": "/v1/documents?company=bluebird-dental&format=csv",
"rows": "/v1/documents?company=bluebird-dental"
}
}
],
"quotes": {
"said": {
"file": "/v1/quotes?company=northwind-dental&format=csv",
"rows": "/v1/quotes?company=northwind-dental"
},
"named": {
"file": "/v1/quotes?named=northwind-dental&format=csv",
"rows": "/v1/quotes?named=northwind-dental"
}
},
"licensed": [],
"reports": [
{
"id": "dlr_01JD9K4M5N6P00000000000000",
"title": "Northwind Dental: first look",
"status": "draft",
"updated_at": "2026-11-14T08:30:00.000Z",
"rows": "/v1/diligence-reports/dlr_01JD9K4M5N6P00000000000000",
"file": "/v1/diligence-reports/dlr_01JD9K4M5N6P00000000000000?format=zip"
}
],
"not_held": [
{
"id": "yelp",
"name": "Yelp",
"family": {
"id": "reviews",
"name": "Reviews"
},
"stands": "waiting",
"why": "It reads against a confirmed yelp_business, and Northwind Dental has none confirmed."
}
],
"download": "/v1/targets/northwind-dental/folder?format=zip"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Everything PodData holds tied to one of the team's targets, a part a company, source by source, each with its files
Everything PodData holds for one of your targets, as files: the index of a folder with a part for each company, the target first, then each confirmed rival and its listed parent and comparables. Each part lists, source by source, its records and signals by kind, each with its count, its first and last day, its CSV file’s address and the same rows as JSON, and its documents. For the target it adds its quotes’ two files, your team’s own licensed figures, your reports on it, and every source that holds nothing, with why. ?format=zip is every file at once, with a README, coverage.csv and this index.
Before: The company is one of your targets, and PodData has read it: after POST /targets/{company}/read, wait for GET /targets/{company}/coverage to show its sources read.
Next: Fetch each file (or rows where a file is held back) by its own address, or the whole download. A long file stops at its row limit and gives the cursor for the rest in X-PodData-Next. Your reports are read whole at GET /diligence-reports/{id}.
Limits: One call for the index and one for the zip. A file is at most 10,000 rows and the zip 100,000 in all; past that, a file is left out and the README gives its address. A review or retail source’s file isn’t handed on yet, so file is null and held says why: read its rows as JSON. Whole documents aren’t in the zip: each is read on its own at GET /documents/{id}, under the key’s daily limit.
curl 'https://api.poddata.ai/v1/targets/northwind-dental/folder' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/targets/{company}/folder"
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}/folder', 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}/folder",
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}/folder"
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}/folder")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/folder")
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": "northwind-dental",
"name": "Northwind Dental"
},
"asked_at": "2026-11-14T09:00:00.000Z",
"window": {
"from": "2023-11-14",
"to": "2026-11-14"
},
"counted": {
"read": 9,
"due": 1,
"waiting": 4,
"off_here": 2,
"by_request": 3,
"not_read": 6,
"not_built": 40
},
"parts": [
{
"role": "target",
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"family": {
"id": "reviews",
"name": "Reviews"
},
"stands": "read",
"why": null,
"last_ok": "2026-11-14T06:20:00.000Z",
"records": [],
"signals": [
{
"kind": "review",
"count": 412,
"from": "2024-02-11",
"to": "2026-11-09",
"file": null,
"rows": "/v1/companies/northwind-dental/signals?source=google-maps&kind=review",
"held": "A review site's file isn't handed on yet: read its rows as JSON."
}
],
"documents": {
"count": 0,
"from": null,
"to": null
},
"pages": null
},
{
"id": "nppes-npi",
"name": "CMS NPPES NPI registry",
"family": {
"id": "health",
"name": "Health"
},
"stands": "read",
"why": null,
"last_ok": "2026-11-14T04:02:00.000Z",
"records": [
{
"kind": "organization",
"count": 3,
"from": "2025-06-18",
"to": "2026-10-02",
"file": "/v1/companies/northwind-dental/records?source=nppes-npi&kind=organization&format=csv",
"rows": "/v1/companies/northwind-dental/records?source=nppes-npi&kind=organization",
"held": null
}
],
"signals": [],
"documents": {
"count": 0,
"from": null,
"to": null
},
"pages": null
}
],
"documents": {
"count": 0,
"file": "/v1/documents?company=northwind-dental&format=csv",
"rows": "/v1/documents?company=northwind-dental"
}
},
{
"role": "rival",
"company": {
"id": "bluebird-dental",
"name": "Bluebird Dental"
},
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"family": {
"id": "reviews",
"name": "Reviews"
},
"stands": null,
"why": null,
"last_ok": "2026-11-14T06:24:00.000Z",
"records": [],
"signals": [
{
"kind": "review",
"count": 268,
"from": "2024-02-11",
"to": "2026-11-09",
"file": null,
"rows": "/v1/companies/bluebird-dental/signals?source=google-maps&kind=review",
"held": "A review site's file isn't handed on yet: read its rows as JSON."
}
],
"documents": {
"count": 0,
"from": null,
"to": null
},
"pages": null
}
],
"documents": {
"count": 0,
"file": "/v1/documents?company=bluebird-dental&format=csv",
"rows": "/v1/documents?company=bluebird-dental"
}
}
],
"quotes": {
"said": {
"file": "/v1/quotes?company=northwind-dental&format=csv",
"rows": "/v1/quotes?company=northwind-dental"
},
"named": {
"file": "/v1/quotes?named=northwind-dental&format=csv",
"rows": "/v1/quotes?named=northwind-dental"
}
},
"licensed": [],
"reports": [
{
"id": "dlr_01JD9K4M5N6P00000000000000",
"title": "Northwind Dental: first look",
"status": "draft",
"updated_at": "2026-11-14T08:30:00.000Z",
"rows": "/v1/diligence-reports/dlr_01JD9K4M5N6P00000000000000",
"file": "/v1/diligence-reports/dlr_01JD9K4M5N6P00000000000000?format=zip"
}
],
"not_held": [
{
"id": "yelp",
"name": "Yelp",
"family": {
"id": "reviews",
"name": "Reviews"
},
"stands": "waiting",
"why": "It reads against a confirmed yelp_business, and Northwind Dental has none confirmed."
}
],
"download": "/v1/targets/northwind-dental/folder?format=zip"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}target_folder, 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
The target, its rivals and its listed parent and comparables, each source with its counts, days and files, and what holds nothing and why; or with format=zip, the files