curl 'https://api.poddata.ai/v1/companies/northwind-dental/numbers/rating-rivals?source=google-maps' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/numbers/rating-rivals"
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}/numbers/rating-rivals', 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}/numbers/rating-rivals",
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}/numbers/rating-rivals"
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}/numbers/rating-rivals")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/numbers/rating-rivals")
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{
"numbers": "rating_rivals",
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"params": {
"source": "google-maps",
"from": "2025-11-17",
"to": "2026-11-16"
},
"figures": [
{
"name": "gap",
"label": "Northwind Dental against its rivals",
"value": -0.3,
"unit": "stars",
"company": null,
"n": null,
"small": false,
"interval": null
},
{
"name": "rivals",
"label": "Confirmed rivals compared",
"value": 1,
"unit": "count",
"company": null,
"n": 1,
"small": false,
"interval": null
}
],
"columns": [
{
"name": "average",
"label": "Average rating",
"unit": "stars"
},
{
"name": "gap",
"label": "Gap",
"unit": "stars"
}
],
"rows": [
{
"key": "northwind-dental",
"label": "Northwind Dental",
"kind": "company",
"company": "northwind-dental",
"values": {
"average": 4.3,
"gap": null
},
"small": false,
"day": null,
"source": null,
"category": null,
"url": null,
"was": null
},
{
"key": "harbor-smiles",
"label": "Harbor Smiles",
"kind": "company",
"company": "harbor-smiles",
"values": {
"average": 4.6,
"gap": 0.3
},
"small": false,
"day": null,
"source": null,
"category": null,
"url": null,
"was": null
}
],
"evidence": {
"items": [
{
"kind": "signal",
"id": "sig_01EXAMPLE00000000000000001",
"source": "google-maps",
"company": "northwind-dental",
"link": "cln_01EXAMPLE00000000000000001",
"day": "2026-10-02",
"url": "https://maps.example/reviews/1",
"row": "northwind-dental",
"rating": null,
"text": null
}
],
"total": 412,
"more": 411
},
"basis": {
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"network": "google-maps"
}
],
"independent": 1,
"window": {
"from": "2025-11-17",
"to": "2026-11-16"
},
"compare": null,
"method": "Made up for this example.",
"sample": {
"read": 412,
"of": 1180,
"from": "2023-02-01",
"to": "2026-11-16",
"days": 1385,
"undated": 0
},
"breaks": [],
"periods": null,
"left_out": [],
"caveats": []
},
"computed_at": "2026-11-17T14:00:00.000Z"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}A company against each of its confirmed rivals, over the same window and source
The company’s rating beside each of its confirmed rivals’, over the same window and source, with the gap between them. A row is the company or a rival. With format=csv its rows are a file under its columns, a number a cell, and with format=csv&part=figures its named figures are, a row each: counts and shares, never a review’s words. Its MCP tool answers the JSON only, since no tool hands over a file.
Before: The company is one of your team’s targets, or any company /companies/{id} takes. A review or record counts only where a link a person confirmed ties it (POST /companies/{id}/links/{link}/confirm), and a rival only once a person confirms it (POST /companies/{id}/rivals/{rival}/confirm). Ask for a read with POST /targets/{company}/read if coverage says a source hasn’t been read.
Next: Put it in a report as an exhibit, {"numbers": "rating_rivals", "company": "…", "params": {…}} with these arguments as its params, through PUT /diligence-reports/{id}/pages/{page}, and cite a figure in the page’s copy as {exhibit-id.figure_name}: the report fills it each time it’s read. Or save the rows with format=csv.
Limits: One api call, as JSON or as a file. At most 200 of the ids behind the figures are listed in evidence, and evidence.more says how many aren’t. Under 30 reviews a figure is small and comes with how many it rests on. part without format=csv is a 400.
curl 'https://api.poddata.ai/v1/companies/northwind-dental/numbers/rating-rivals?source=google-maps' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/numbers/rating-rivals"
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}/numbers/rating-rivals', 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}/numbers/rating-rivals",
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}/numbers/rating-rivals"
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}/numbers/rating-rivals")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/numbers/rating-rivals")
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{
"numbers": "rating_rivals",
"company": {
"id": "northwind-dental",
"name": "Northwind Dental"
},
"params": {
"source": "google-maps",
"from": "2025-11-17",
"to": "2026-11-16"
},
"figures": [
{
"name": "gap",
"label": "Northwind Dental against its rivals",
"value": -0.3,
"unit": "stars",
"company": null,
"n": null,
"small": false,
"interval": null
},
{
"name": "rivals",
"label": "Confirmed rivals compared",
"value": 1,
"unit": "count",
"company": null,
"n": 1,
"small": false,
"interval": null
}
],
"columns": [
{
"name": "average",
"label": "Average rating",
"unit": "stars"
},
{
"name": "gap",
"label": "Gap",
"unit": "stars"
}
],
"rows": [
{
"key": "northwind-dental",
"label": "Northwind Dental",
"kind": "company",
"company": "northwind-dental",
"values": {
"average": 4.3,
"gap": null
},
"small": false,
"day": null,
"source": null,
"category": null,
"url": null,
"was": null
},
{
"key": "harbor-smiles",
"label": "Harbor Smiles",
"kind": "company",
"company": "harbor-smiles",
"values": {
"average": 4.6,
"gap": 0.3
},
"small": false,
"day": null,
"source": null,
"category": null,
"url": null,
"was": null
}
],
"evidence": {
"items": [
{
"kind": "signal",
"id": "sig_01EXAMPLE00000000000000001",
"source": "google-maps",
"company": "northwind-dental",
"link": "cln_01EXAMPLE00000000000000001",
"day": "2026-10-02",
"url": "https://maps.example/reviews/1",
"row": "northwind-dental",
"rating": null,
"text": null
}
],
"total": 412,
"more": 411
},
"basis": {
"sources": [
{
"id": "google-maps",
"name": "Google Maps reviews and listings",
"network": "google-maps"
}
],
"independent": 1,
"window": {
"from": "2025-11-17",
"to": "2026-11-16"
},
"compare": null,
"method": "Made up for this example.",
"sample": {
"read": 412,
"of": 1180,
"from": "2023-02-01",
"to": "2026-11-16",
"days": 1385,
"undated": 0
},
"breaks": [],
"periods": null,
"left_out": [],
"caveats": []
},
"computed_at": "2026-11-17T14:00:00.000Z"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}numbers_rating_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
Query Parameters
Response
A row the company and each confirmed rival