Company - Firmographics

Retrieve a company’s firmographic profile: name, domain, industry, employee and revenue ranges, HQ country/city, and other identifiers.
Use this for account 360° views, enrichment, scoring, and segmentation.

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

---

Endpoint

GET /companies/{companyDomain}/firmographics

Path parameters

Name	Type	Required	Description
companyDomain	string	Yes	Company domain (e.g. hilton.com)

Returns a single JSON object with firmographic attributes.

---

Example — Get firmographics

Bash

curl -sS "https://api.salescaddy.ai/api/companies/hilton.com/firmographics" \
  -H "Authorization: Bearer $TOKEN"

Node

const url = "https://api.salescaddy.ai/api/companies/hilton.com/firmographics";
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/firmographics",
                 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/firmographics");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Sample response (trimmed):

JSON

{
  "domain": "hilton.com",
  "name": "Hilton",
  "industry": "Hospitality",
  "employeeRange": "10001+",
  "revenueRange": "10B+",
  "foundedYear": 1919,
  "hqCountry": "US",
  "hqCity": "McLean",
  "linkedinUrl": "https://www.linkedin.com/company/hilton/",
  "crunchbaseUrl": "https://www.crunchbase.com/organization/hilton"
}

---

Data fields (common)

Field	Type	Example	Notes
domain	string	hilton.com	Primary key used across endpoints
name	string	Hilton	Legal or common display name
industry	string	Hospitality
employeeRange	string	10001+	Categorical band
revenueRange	string	10B+	Categorical band
foundedYear	number	1919	Optional
hqCountry	string	US	ISO‑2
hqCity	string	McLean	Optional
linkedinUrl	string	https://linkedin.com/...	Optional
crunchbaseUrl	string	https://crunchbase.com/...	Optional

The exact shape can evolve. Rely on field presence checks and defaults in your integration.

---

Tips & best practices

• Use domain as the join key to correlate with products, cohorts, metrics, and feed.
• Combine with Usage Metrics to qualify opportunities by tech adoption.
• Cache firmographics (they change less frequently than feed or products).
• Validate and normalize industry names if you do cohorting by industry.

---

Errors

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

---