curl -X POST 'https://api.poddata.ai/v1/targets/northwind-dental/rivals/find' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"list":[{"name":"Bluebird Dental","domain":"bluebird-dental.example"},{"name":"Summit Dental Supply","domain":"summit-dental-supply.example"}],"from":["list"]}'import requests
url = "https://api.poddata.ai/v1/targets/{company}/rivals/find"
payload = {
"list": [
{
"name": "Bluebird Dental",
"domain": "bluebird-dental.example"
},
{
"name": "Summit Dental Supply",
"domain": "summit-dental-supply.example"
}
],
"from": ["list"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
list: [
{name: 'Bluebird Dental', domain: 'bluebird-dental.example'},
{name: 'Summit Dental Supply', domain: 'summit-dental-supply.example'}
],
from: ['list']
})
};
fetch('https://api.poddata.ai/v1/targets/{company}/rivals/find', 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}/rivals/find",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'list' => [
[
'name' => 'Bluebird Dental',
'domain' => 'bluebird-dental.example'
],
[
'name' => 'Summit Dental Supply',
'domain' => 'summit-dental-supply.example'
]
],
'from' => [
'list'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/targets/{company}/rivals/find"
payload := strings.NewReader("{\n \"list\": [\n {\n \"name\": \"Bluebird Dental\",\n \"domain\": \"bluebird-dental.example\"\n },\n {\n \"name\": \"Summit Dental Supply\",\n \"domain\": \"summit-dental-supply.example\"\n }\n ],\n \"from\": [\n \"list\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.poddata.ai/v1/targets/{company}/rivals/find")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"list\": [\n {\n \"name\": \"Bluebird Dental\",\n \"domain\": \"bluebird-dental.example\"\n },\n {\n \"name\": \"Summit Dental Supply\",\n \"domain\": \"summit-dental-supply.example\"\n }\n ],\n \"from\": [\n \"list\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/rivals/find")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"list\": [\n {\n \"name\": \"Bluebird Dental\",\n \"domain\": \"bluebird-dental.example\"\n },\n {\n \"name\": \"Summit Dental Supply\",\n \"domain\": \"summit-dental-supply.example\"\n }\n ],\n \"from\": [\n \"list\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"target": {
"about": "General and cosmetic dentistry for families, at three clinics in Riverside County, California",
"from": "site",
"page": "https://northwind-dental.example/"
},
"proposed": [
{
"name": "Bluebird Dental",
"domain": "bluebird-dental.example",
"found": {
"from": "list",
"source": null,
"why": "On your list",
"url": null
},
"verdict": "rival",
"sells": "General and cosmetic dentistry",
"to": "Families and adults",
"where": "Riverside and Corona, California",
"shows": {
"words": "Family dentistry in Riverside and Corona, with same-day crowns and cleanings for all ages.",
"page": "https://bluebird-dental.example/"
},
"reads": [
{
"model": "first model",
"verdict": "rival",
"why": "The same care for the same patients in the same towns."
},
{
"model": "second model",
"verdict": "rival",
"why": "General dentistry in two of the target’s towns."
}
],
"overlap": {
"codes": [
"NPI specialty 1223G0001X"
],
"towns": [
"Riverside"
],
"terms": [
"crowns",
"cleanings",
"family"
],
"supported": true
},
"why": "Both reads say it sells general dentistry to families in Riverside.",
"rival": {
"id": "bluebird-dental",
"name": "Bluebird Dental"
},
"state": "proposed",
"added": true
}
],
"left_out": [
{
"name": "Summit Dental Supply",
"domain": "summit-dental-supply.example",
"found": {
"from": "list",
"source": null,
"why": "On your list",
"url": null
},
"verdict": "supplier",
"sells": "Instruments and consumables for dental practices",
"to": "Dental practices",
"where": "The United States",
"shows": {
"words": "Everything your practice needs, from impression trays to autoclaves, shipped next day.",
"page": "https://summit-dental-supply.example/"
},
"reads": [
{
"model": "first model",
"verdict": "supplier",
"why": "It sells to practices like the target."
},
{
"model": "second model",
"verdict": "supplier",
"why": "A distributor to dental offices."
}
],
"overlap": {
"codes": [],
"towns": [],
"terms": [],
"supported": false
},
"why": "It supplies dental practices, so it isn’t a rival."
}
],
"decided": [],
"not_tested": [],
"sources": [
{
"from": "list",
"looked": true,
"found": 2,
"why": null
},
{
"from": "records",
"looked": false,
"found": 0,
"why": "Not asked for"
},
{
"from": "news",
"looked": false,
"found": 0,
"why": "Not asked for"
},
{
"from": "web",
"looked": false,
"found": 0,
"why": "Not asked for"
}
],
"cost": {
"usd": 0.03,
"model_calls": 4,
"searches": 0,
"pages": 7
},
"asked_today": 1,
"limit": 3
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Finds one of the team's targets' rivals: candidates tested like for like from their own sites, only the rivals proposed
Finds one of your targets’ rivals. PodData gathers candidates from your list, from the records it holds (a licensing board’s other licensees, the same specialty in the same towns), from stories and deals that name the target, and from the open web where that’s on here; sources says where it looked. It reads each candidate’s own site and has two models of different families say, blind to each other, what it sells, to whom and where, and so what it is to the target. Only a rival both agree on is proposed, never confirmed; every other candidate comes back in left_out with its verdict and why (a supplier, a different buyer, a different product, another business of the same name, or unclear). overlap says what the two firms share that no model said: industry codes, towns and words, and supported: false marks a rival only the models’ reading backs.
Before: The company is one of your targets. Give about, what it sells, to whom and where, if its own site can’t be read: a site whose terms bar reading it is a 400 that asks for it.
Next: Show each proposed rival, its page and why to a person, and confirm the right ones with POST /companies/{id}/rivals/{rival}/confirm.
Limits: At most 15 candidates tested an ask, your list first; the rest come back in not_tested. As many asks a UTC day as the plan’s rival finds, 1 on Free, 3 on Pro and Pilot, and no limit on Enterprise; past it, a 403 with the code plan. cost says what the ask spent. A rival confirmed or struck already isn’t tested again.
curl -X POST 'https://api.poddata.ai/v1/targets/northwind-dental/rivals/find' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"list":[{"name":"Bluebird Dental","domain":"bluebird-dental.example"},{"name":"Summit Dental Supply","domain":"summit-dental-supply.example"}],"from":["list"]}'import requests
url = "https://api.poddata.ai/v1/targets/{company}/rivals/find"
payload = {
"list": [
{
"name": "Bluebird Dental",
"domain": "bluebird-dental.example"
},
{
"name": "Summit Dental Supply",
"domain": "summit-dental-supply.example"
}
],
"from": ["list"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
list: [
{name: 'Bluebird Dental', domain: 'bluebird-dental.example'},
{name: 'Summit Dental Supply', domain: 'summit-dental-supply.example'}
],
from: ['list']
})
};
fetch('https://api.poddata.ai/v1/targets/{company}/rivals/find', 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}/rivals/find",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'list' => [
[
'name' => 'Bluebird Dental',
'domain' => 'bluebird-dental.example'
],
[
'name' => 'Summit Dental Supply',
'domain' => 'summit-dental-supply.example'
]
],
'from' => [
'list'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/targets/{company}/rivals/find"
payload := strings.NewReader("{\n \"list\": [\n {\n \"name\": \"Bluebird Dental\",\n \"domain\": \"bluebird-dental.example\"\n },\n {\n \"name\": \"Summit Dental Supply\",\n \"domain\": \"summit-dental-supply.example\"\n }\n ],\n \"from\": [\n \"list\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.poddata.ai/v1/targets/{company}/rivals/find")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"list\": [\n {\n \"name\": \"Bluebird Dental\",\n \"domain\": \"bluebird-dental.example\"\n },\n {\n \"name\": \"Summit Dental Supply\",\n \"domain\": \"summit-dental-supply.example\"\n }\n ],\n \"from\": [\n \"list\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/rivals/find")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"list\": [\n {\n \"name\": \"Bluebird Dental\",\n \"domain\": \"bluebird-dental.example\"\n },\n {\n \"name\": \"Summit Dental Supply\",\n \"domain\": \"summit-dental-supply.example\"\n }\n ],\n \"from\": [\n \"list\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"target": {
"about": "General and cosmetic dentistry for families, at three clinics in Riverside County, California",
"from": "site",
"page": "https://northwind-dental.example/"
},
"proposed": [
{
"name": "Bluebird Dental",
"domain": "bluebird-dental.example",
"found": {
"from": "list",
"source": null,
"why": "On your list",
"url": null
},
"verdict": "rival",
"sells": "General and cosmetic dentistry",
"to": "Families and adults",
"where": "Riverside and Corona, California",
"shows": {
"words": "Family dentistry in Riverside and Corona, with same-day crowns and cleanings for all ages.",
"page": "https://bluebird-dental.example/"
},
"reads": [
{
"model": "first model",
"verdict": "rival",
"why": "The same care for the same patients in the same towns."
},
{
"model": "second model",
"verdict": "rival",
"why": "General dentistry in two of the target’s towns."
}
],
"overlap": {
"codes": [
"NPI specialty 1223G0001X"
],
"towns": [
"Riverside"
],
"terms": [
"crowns",
"cleanings",
"family"
],
"supported": true
},
"why": "Both reads say it sells general dentistry to families in Riverside.",
"rival": {
"id": "bluebird-dental",
"name": "Bluebird Dental"
},
"state": "proposed",
"added": true
}
],
"left_out": [
{
"name": "Summit Dental Supply",
"domain": "summit-dental-supply.example",
"found": {
"from": "list",
"source": null,
"why": "On your list",
"url": null
},
"verdict": "supplier",
"sells": "Instruments and consumables for dental practices",
"to": "Dental practices",
"where": "The United States",
"shows": {
"words": "Everything your practice needs, from impression trays to autoclaves, shipped next day.",
"page": "https://summit-dental-supply.example/"
},
"reads": [
{
"model": "first model",
"verdict": "supplier",
"why": "It sells to practices like the target."
},
{
"model": "second model",
"verdict": "supplier",
"why": "A distributor to dental offices."
}
],
"overlap": {
"codes": [],
"towns": [],
"terms": [],
"supported": false
},
"why": "It supplies dental practices, so it isn’t a rival."
}
],
"decided": [],
"not_tested": [],
"sources": [
{
"from": "list",
"looked": true,
"found": 2,
"why": null
},
{
"from": "records",
"looked": false,
"found": 0,
"why": "Not asked for"
},
{
"from": "news",
"looked": false,
"found": 0,
"why": "Not asked for"
},
{
"from": "web",
"looked": false,
"found": 0,
"why": "Not asked for"
}
],
"cost": {
"usd": 0.03,
"model_calls": 4,
"searches": 0,
"pages": 7
},
"asked_today": 1,
"limit": 3
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}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
Body
Response
What it found: the rivals proposed, never confirmed, and every other candidate left out with why