Company - Cohorts

Retrieve cohort members for a given company.
Cohorts let you benchmark a company against its peers.

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

Required enum: cohort (path) must be one of Default, Defined, Aspirational (type: CohortTypeEnum).
Use pagination with page / size to iterate results.

---

Endpoint

GET /companies/{companyDomain}/cohort/{cohort}

Path parameters

Name	Type	Required	Description
companyDomain	string	Yes	Subject company domain (e.g. hilton.com)
cohort	CohortTypeEnum	Yes	One of: Default, Defined, Aspirational

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 Default cohort

Bash

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

Node

const url = "https://api.salescaddy.ai/api/companies/hilton.com/cohort/Default?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/cohort/Default",
                 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/cohort/Default?page=0&size=10");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Sample response (trimmed):

JSON

{
  "totalPages": 10412,
  "totalElements": 208229,
  "content": [
    {
      "domain": "hotellauri.it",
      "name": "S.I.C.T.A. SAS DI SCHEGGIA ARIANNA SEVERINE",
      "logo": "https://img.logo.dev/hotellauri.it?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
    {
      "domain": "hotel-restaurant-rabennest.de",
      "name": "Ilona Lemm-Hirsch",
      "logo": "https://img.logo.dev/hotel-restaurant-rabennest.de?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
    {
      "domain": "villamiralbenga.com",
      "name": "MICRO DOMUS DI ROBERTA GIANFAGNA",
      "logo": "https://img.logo.dev/villamiralbenga.com?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
    {
      "domain": "tachicklakeresort.com",
      "name": "513138 BC Ltd",
      "logo": "https://img.logo.dev/tachicklakeresort.com?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
    {
      "domain": "lile-normande.com.es",
      "name": "MARIE HEBERGEMENT ET LOISIRS",
      "logo": "https://img.logo.dev/lile-normande.com.es?token=pk_S-z4OHSVRdqZEzd20vlKcw"
    },
....
  ]
}

---

Example — Defined cohort

Bash

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

Node

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

Python

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

C#

var res = await http.GetAsync("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Defined?page=0&size=10");
Console.WriteLine(await res.Content.ReadAsStringAsync());

---

Example — Aspirational cohort

Bash

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

Node

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

Python

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

C#

var res = await http.GetAsync("https://api.salescaddy.ai/api/companies/hilton.com/cohort/Aspirational?page=0&size=10");
Console.WriteLine(await res.Content.ReadAsStringAsync());

---

Semantics of cohorts

• Default — automatically derived peer set based on industry, size, region, and stack signals.
• Defined — curated cohort of competitors and peers (manually or via configuration) for this company.
• Aspirational — forward‑looking peer group a company aims to resemble.

Use the same cohort value when calling Usage Metrics to benchmark adoption/intensity/penetration.

---

Errors

Code	Meaning	How to fix
400	Bad request	Validate cohort value and page/size.
401	Unauthorized	Provide/refresh Bearer token.
403	Forbidden	Check client permissions.
404	Not found	Unknown companyDomain or cohort not configured.
429	Rate limit exceeded	Retry with exponential backoff; respect Retry-After.
500	Internal server error	Retry later; contact support if persistent.

---