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

curl -X 'GET' \
  'https://api.salescaddy.ai/api/companies/hilton.com/firmographics' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer $TOKEN"

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

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

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

{
  "acquisition": [
    {
      "amount": "136000000",
      "date": "Wed Feb 15 00:15:22 UTC 2023",
      "name": "Midtown Timeshare Hotel",
      "status": "Acquired",
      "undisclosed": "false"
    },
    {
      "amount": "210000000",
      "company_id": "5720793",
      "date": "Fri Mar 15 04:58:32 UTC 2024",
      "name": "Graduate Hotels",
      "status": "Acquisition Pending",
      "undisclosed": "false",
      "website": "graduatehotels.com"
    },
    {
      "date": "Mon Oct 01 00:00:00 UTC 2012",
      "name": "Triangeln Hotel"
    },
    {
      "company_id": "1403846",
      "date": "Mon Apr 15 15:57:04 UTC 2024",
      "name": "Sydell Group, LLC",
      "status": "Acquired",
      "undisclosed": "true",
      "website": "sydellgroup.com"
    },
    {
      "date": "Sun Oct 15 18:23:03 UTC 2017",
      "name": "Icelandic Seachill",
      "status": "Subsidiary",
      "undisclosed": "true"
    },
    {
      "company_id": "2236200",
      "date": "Thu Feb 19 18:30:00 UTC 2015",
      "name": "Parc",
      "status": "Subsidiary",
      "undisclosed": "true",
      "website": "parc55hotel.com"
    },
    {
      "company_id": "4031816",
      "date": "Wed Feb 18 18:30:00 UTC 2015",
      "name": "Hilton Orlando Bonnet Creek",
      "status": "Subsidiary",
      "undisclosed": "true",
      "website": "hiltonbonnetcreek.com"
    },
    {
      "company_id": "1853241",
      "date": "Thu Feb 19 18:30:00 UTC 2015",
      "name": "Waldorf Astoria Orlando",
      "status": "Subsidiary",
      "undisclosed": "true",
      "website": "waldorfastoriaorlando.com"
    }
  ],
  "ceo": {
    "first_name": "Christopher J. ",
    "image_url": "https://s3.amazonaws.com/owler-image/ceo/Christopher J. _Nassetta_owler_20211101_155819_original.png",
    "last_name": "Nassetta"
  },
  "company_id": 136270,
  "company_type": "Public",
  "description": "Hilton is a Virginia-based hospitality company that owns, manages and franchises a portfolio of hotels and resorts offering services such as lodging and event management.",
  "employee_count": "181000.0",
  "facebook_link": "https://www.facebook.com/Hilton/",
  "founded_date": "1919",
  "funding": [
    {
      "amount": "2352812480",
      "date": "Wed Dec 11 18:30:00 UTC 2013",
      "type": "IPO",
      "undisclosed": "false"
    }
  ],
  "hq_address": {
    "city": "McLean",
    "country": "USA",
    "phone": "1-703-883-1000",
    "postal_code": "22102",
    "state": "US-VA",
    "street1": "7930 Jones Branch Drive"
  },
  "industries": [
    "Travel, Recreation & Leisure"
  ],
  "linkedin_link": "https://www.linkedin.com/company/hilton/",
  "logo_url": "https://s3.amazonaws.com/owler-image/logo/hilton_owler_20170217_083454_original.png",
  "name": "Hilton Worldwide Holdings, Inc.",
  "perm_id": "https://permid.org/1-5040250025",
  "profile_url": "https://www.owler.com/iaApp/136270/hilton-company-profile",
  "revenue": "13362000000",
  "short_name": "Hilton",
  "sic_code": [
    "7011",
    "7011"
  ],
  "stock": {
    "exchange": "NYSE",
    "ticker": "HLT"
  },
  "twitter_link": "https://twitter.com/hiltonhotels",
  "website": "http://www.hiltonworldwide.com/",
  "youtube_link": "https://www.youtube.com/@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.