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

A path into the records’ fields: total_agr, counties.031.units, figures[Gross Revenue].value

Required string length: 1 - 120
to
string

The last month, YYYY-MM: the latest the source holds if left out

Pattern: ^\d{4}-\d{2}$
months
integer

How many months the window holds, ending on to: 12 if left out

Required range: 1 <= x <= 60
compare
enum<string>

prior (the default): the same number of months just before; none: no second window

Available options:
prior,
none

One of the company's confirmed links (cln_…), such as one casino of a group: only its records

Maximum string length: 64
key
string

For a county's or a state's series that ties to no company: its records' own id at the source without the period

Required string length: 1 - 200
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 period

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