Skip to main content
GET
curl, made-up values
MCP tool: numbers_complaints, 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

Authorization
string
header
required

An API key, sent as Authorization: Bearer pd_live_…. Someone on your team makes one in the workspace, Settings › API keys; it's shown once. Staging's keys start with pd_test_.

Path Parameters

id
string
required
Maximum string length: 64

Query Parameters

source
string
required

A source's catalog id, such as google-maps

Required string length: 1 - 64
topics
string
required

Topics, each a label, a colon and its terms split by |, the topics split by ;: "Billing:bill|charge|invoice;AI phone:AI|robot|phone tree". A term counts where a word starts with it, and a term in capitals keeps its case

Required string length: 3 - 2000
from
string<date>

The window's first day, by the reviews' own days. A year before to if left out

to
string<date>

The window's last day. Today if left out

max_stars
integer

The highest rating that counts as unhappy: 2, one and two stars, if left out

Required range: 1 <= x <= 5
format
enum<string>

csv: the answer as a file, its rows under its columns, or with part=figures its named figures. json: the answer, the default

Available options:
json,
csv
Example:

"csv"

part
enum<string>

With format=csv: rows (the default), the table behind the chart, a row each with a column for each of its columns; or figures, a row each with its label, value, unit, company, n and interval

Available options:
rows,
figures
Example:

"figures"

Response

A row a company a topic, and samples in the evidence

numbers
enum<string>
required
Available options:
rating,
rating_by_link,
rating_rivals,
rating_windows,
complaints,
series,
timeline,
ads,
ads_weeks,
site,
site_changes
company
object
required
params
object
required
figures
object[]
required
columns
object[]
required
rows
object[]
required
evidence
object
required
basis
object
required
computed_at
string
required