curl, made-up values
curl -X POST 'https://api.poddata.ai/v1/companies/northwind-dental/links/cln_01JD8X4K2P7S00000000000000/confirm' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{}'import requests
url = "https://api.poddata.ai/v1/companies/{id}/links/{link}/confirm"
payload = {}
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({})
};
fetch('https://api.poddata.ai/v1/companies/{id}/links/{link}/confirm', 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/{link}/confirm",
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([
]),
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/companies/{id}/links/{link}/confirm"
payload := strings.NewReader("{}")
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/companies/{id}/links/{link}/confirm")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/links/{link}/confirm")
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 = "{}"
response = http.request(request)
puts response.read_body{
"id": "cln_01JD8X4K2P7S00000000000000",
"kind": "instagram",
"value": "northwinddental",
"evidence": "https://northwind-dental.example/",
"state": "confirmed",
"decided_at": "2026-11-12T15:30:00.000Z",
"waits_for": null
}{
"id": "<string>",
"kind": "<string>",
"value": "<string>",
"state": "proposed",
"evidence": "<string>",
"decided_at": "<string>",
"waits_for": "team"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Links
Confirms one of a target's links, with the page that shows it's theirs
Confirms one of a target’s links, or a confirmed rival’s, so PodData’s readers read through it from their next run. Give evidence, the page that shows it’s theirs, where the link has none. 200 with the link confirmed.
Before: A person has seen the link and its page and said yes. An assistant never confirms one on its own: it shows the page and asks.
Next: Once its links are confirmed, POST /targets/{company}/read asks PodData to read the company now rather than on each source’s own cadence.
Limits: A value confirmed for another company is a 409. Confirming a link that has no evidence, without giving one, is a 400.
POST
/
companies
/
{id}
/
links
/
{link}
/
confirm
curl, made-up values
curl -X POST 'https://api.poddata.ai/v1/companies/northwind-dental/links/cln_01JD8X4K2P7S00000000000000/confirm' \
-H "Authorization: Bearer $PODDATA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{}'import requests
url = "https://api.poddata.ai/v1/companies/{id}/links/{link}/confirm"
payload = {}
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({})
};
fetch('https://api.poddata.ai/v1/companies/{id}/links/{link}/confirm', 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/{link}/confirm",
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([
]),
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/companies/{id}/links/{link}/confirm"
payload := strings.NewReader("{}")
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/companies/{id}/links/{link}/confirm")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/links/{link}/confirm")
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 = "{}"
response = http.request(request)
puts response.read_body{
"id": "cln_01JD8X4K2P7S00000000000000",
"kind": "instagram",
"value": "northwinddental",
"evidence": "https://northwind-dental.example/",
"state": "confirmed",
"decided_at": "2026-11-12T15:30:00.000Z",
"waits_for": null
}{
"id": "<string>",
"kind": "<string>",
"value": "<string>",
"state": "proposed",
"evidence": "<string>",
"decided_at": "<string>",
"waits_for": "team"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}MCP tool:
confirm_link, 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
Path Parameters
Body
application/json