Company - Competitors

Get for the given company domain.
This endpoint returns a paginated list of peer companies (schema: CompanyPagedDTO).

Base URL: https://api.salescaddy.ai/api

---

Endpoint

GET /companies/{companyDomain}/competitors

Path parameters

Name	Type	Required	Description
companyDomain	string	Yes	e.g. hilton.com

Query parameters

Name	Type	Required	Default	Description
page	int	No	0	Page index (0-based)
size	int	No	20	Page size (max 200)

---

Example — Get competitors

Bash

curl -sS "https://api.salescaddy.ai/api/companies/hilton.com/competitors?page=0&size=10" \
  -H "Authorization: Bearer $TOKEN"

Node

const url = "https://api.salescaddy.ai/api/companies/hilton.com/competitors?page=0&size=10";
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.TOKEN}` } });
console.log(await res.json());

Python

import os, requests
r = requests.get("https://api.salescaddy.ai/api/companies/hilton.com/competitors",
                 params={"page":0,"size":10},
                 headers={"Authorization": f"Bearer {os.environ['TOKEN']}"})
print(r.json())

C#

using System.Net.Http.Headers;
var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", TOKEN);
var res = await http.GetAsync("https://api.salescaddy.ai/api/companies/hilton.com/competitors?page=0&size=10");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Sample response (trimmed):

JSON

{
  "totalPages": 3,
  "totalElements": 47,
  "content": [
    {
      "id": "comp_marriott",
      "domain": "marriott.com",
      "name": "Marriott International",
      "employeeRange": "10001+",
      "revenueRange": "10B+",
      "industry": "Hospitality",
      "country": "US"
    },
    {
      "id": "comp_hyatt",
      "domain": "hyatt.com",
      "name": "Hyatt Hotels Corporation",
      "employeeRange": "5001-10000",
      "revenueRange": "5B-10B",
      "industry": "Hospitality",
      "country": "US"
    }
  ]
}

The list is limited to 50 peers per subject company. Use pagination (page/size) to page through results.

---

Errors

Code	Meaning	How to fix
400	Bad request	Validate companyDomain, page/size
401	Unauthorized	Provide/refresh Bearer token
403	Forbidden	Check client permissions
404	Not found	Unknown companyDomain or no competitors
429	Rate limit exceeded	Retry with exponential backoff
500	Internal server error	Retry later; contact support if persistent

---