curl 'https://api.poddata.ai/v1/companies/northwind-dental/links' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/links"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/companies/{id}/links', 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/companies/{id}/links",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/companies/{id}/links"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poddata.ai/v1/companies/{id}/links")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/links")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "cln_01JD8X4K2M9Q00000000000000",
"kind": "domain",
"value": "northwind-dental.example",
"state": "confirmed",
"evidence": "https://northwind-dental.example/",
"decided_at": "2026-11-12T15:20:00.000Z"
},
{
"id": "cln_01JD8X4K2N3R00000000000000",
"kind": "google_place",
"value": "ChIJ_made_up_riverside",
"state": "confirmed",
"evidence": "https://northwind-dental.example/locations/riverside",
"decided_at": "2026-11-12T15:21:00.000Z"
},
{
"id": "cln_01JD8X4K2P7S00000000000000",
"kind": "instagram",
"value": "northwinddental",
"state": "proposed",
"evidence": "https://northwind-dental.example/",
"decided_at": null
}
]
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}A company's links, with which are confirmed
A company’s links, confirmed first: its domain, its places on Google, its listings and accounts, and its numbers at registries such as the SEC and the NPI registry. Each has its kind, its value, its state (proposed, confirmed or struck), the page that shows it’s theirs, and when a person decided it. PodData reads a company only through its confirmed links.
Before: The company is one your team may see: on PodData’s list, one of your targets, or a confirmed rival of one.
Next: Show each proposed link and its page to a person. On their yes, POST /companies/{id}/links/{link}/confirm; on their no, POST /companies/{id}/links/{link}/strike. Propose one PodData missed with POST /companies/{id}/links.
Limits: Every link at once, no pages. A company your team can’t see is a 404, which says nothing of whether anyone else has it.
curl 'https://api.poddata.ai/v1/companies/northwind-dental/links' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/links"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/companies/{id}/links', 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/companies/{id}/links",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.poddata.ai/v1/companies/{id}/links"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.poddata.ai/v1/companies/{id}/links")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/links")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "cln_01JD8X4K2M9Q00000000000000",
"kind": "domain",
"value": "northwind-dental.example",
"state": "confirmed",
"evidence": "https://northwind-dental.example/",
"decided_at": "2026-11-12T15:20:00.000Z"
},
{
"id": "cln_01JD8X4K2N3R00000000000000",
"kind": "google_place",
"value": "ChIJ_made_up_riverside",
"state": "confirmed",
"evidence": "https://northwind-dental.example/locations/riverside",
"decided_at": "2026-11-12T15:21:00.000Z"
},
{
"id": "cln_01JD8X4K2P7S00000000000000",
"kind": "instagram",
"value": "northwinddental",
"state": "proposed",
"evidence": "https://northwind-dental.example/",
"decided_at": null
}
]
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}company_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.