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

by
enum<string>

What a row is: a star (the default) or a month, by the reviews’ own days

Available options:
stars,
month
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

The figures, their rows, their evidence and how they were built

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