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

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

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());

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())

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):

{
  {
  "totalPages": 1,
  "totalElements": 20,
  "content": [
    {
      "domain": "marriott.com",
      "name": "Marriott International, Inc.",
      "logo": "https://img.logo.dev/marriott.com?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
    {
      "domain": "hyatt.com",
      "name": "Hyatt Corporation",
      "logo": "https://img.logo.dev/hyatt.com?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
    {
      "domain": "ihgplc.com",
      "name": "InterContinental Hotels Group, PLC",
      "logo": "https://img.logo.dev/ihgplc.com?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
	...
  ]
}

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