curl -X POST 'https://api.poddata.ai/v1/targets/northwind-dental/find' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/targets/{company}/find"
payload = { "rival": "<string>" }
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({rival: '<string>'})
};
fetch('https://api.poddata.ai/v1/targets/{company}/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}/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([
'rival' => '<string>'
]),
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}/find"
payload := strings.NewReader("{\n \"rival\": \"<string>\"\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}/find")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rival\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/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 \"rival\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"sites": [
{
"domain": "northwind-dental.example",
"read": true,
"why": null,
"terms": "https://northwind-dental.example/terms",
"pages": [
"https://northwind-dental.example/",
"https://northwind-dental.example/locations",
"https://northwind-dental.example/locations/riverside"
]
}
],
"proposed": [
{
"id": "cln_01JD8X4K2P7S00000000000000",
"kind": "instagram",
"value": "northwinddental",
"page": "https://northwind-dental.example/",
"state": "proposed",
"added": true
}
],
"skipped": [],
"addresses": [
{
"address": "1200 Market Street, Riverside, CA 92501",
"page": "https://northwind-dental.example/locations/riverside"
}
],
"recent": null,
"overlap": null
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Reads one of the team's targets' own site, or a confirmed rival's, and proposes the accounts it links to and the addresses it gives
Reads one of your targets’ own site, at its proposed or confirmed domain, and proposes each account its pages link to (Instagram, TikTok, X, YouTube, Facebook, LinkedIn), each with the page that links to it, never confirming one. It answers the street addresses on its location pages too, each with its page, for a person to match to listings. With {"rival": "…"}, a confirmed rival’s site is read instead, kept to the towns where the target has a confirmed place. Only what the company’s own pages show is proposed: a search result never is.
Before: The company is one of your targets with a domain, proposed or confirmed. For a rival, the pair is confirmed: otherwise a 409.
Next: Show each proposed account and its page to a person, and confirm the right ones with POST /companies/{id}/links/{link}/confirm.
Limits: PodData reads a site as PodData/1.0, after its robots.txt and its terms, twelve pages at most, and a company’s site once an hour whoever asks: a second ask within the hour answers what the first found (recent). A site whose robots.txt or terms bar it isn’t read, and sites says why.
curl -X POST 'https://api.poddata.ai/v1/targets/northwind-dental/find' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/targets/{company}/find"
payload = { "rival": "<string>" }
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({rival: '<string>'})
};
fetch('https://api.poddata.ai/v1/targets/{company}/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}/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([
'rival' => '<string>'
]),
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}/find"
payload := strings.NewReader("{\n \"rival\": \"<string>\"\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}/find")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rival\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/targets/{company}/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 \"rival\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"sites": [
{
"domain": "northwind-dental.example",
"read": true,
"why": null,
"terms": "https://northwind-dental.example/terms",
"pages": [
"https://northwind-dental.example/",
"https://northwind-dental.example/locations",
"https://northwind-dental.example/locations/riverside"
]
}
],
"proposed": [
{
"id": "cln_01JD8X4K2P7S00000000000000",
"kind": "instagram",
"value": "northwinddental",
"page": "https://northwind-dental.example/",
"state": "proposed",
"added": true
}
],
"skipped": [],
"addresses": [
{
"address": "1200 Market Street, Riverside, CA 92501",
"page": "https://northwind-dental.example/locations/riverside"
}
],
"recent": null,
"overlap": null
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}find_links, 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 its own site shows: each account proposed with its page, never confirmed