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

company
string
required
Maximum string length: 64

Body

application/json
list
object[]

Candidates the caller gives, each a name and, where known, its own domain. At most 15 are tested an ask

Maximum array length: 40
about
string

What the target sells, to whom and where, in a sentence: read from its own site when left out

Required string length: 10 - 500
from
enum<string>[]

Where to look: list, records, news and web. All of them if left out

Minimum array length: 1
Available options:
list,
records,
news,
web

Response

What it found: the rivals proposed, never confirmed, and every other candidate left out with why

company
object
required
target
object
required
proposed
object[]
required
left_out
object[]
required
decided
object[]
required
not_tested
object[]
required
sources
object[]
required
cost
object
required
asked_today
integer
required
limit
integer | null
required