The industries dictionary provides the taxonomy of all supported industries.
Use it for enrichment, segmentation, and as filters in Companies and Profiles search.

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

Endpoints

GET /industries
Returns the full dictionary (JSON). With export=true → CSV file (binary).
GET /industries/{industryId}
Returns details for a specific industry.

Headers

Authorization: Bearer <token> — required
X-On-Behalf-Of-User: you@yourcompany.com — required only when export=true

Example — Get all industries (JSON)

curl -X 'GET' \
  'https://api.salescaddy.ai/api/dictionary/industries' \
  -H 'accept: application/json' \
-H "Authorization: Bearer $TOKEN"

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

Sample response (trimmed):

[
  "abrasive products",
  "accident and health insurance",
  "accounting & accounting services",
  "accounting, auditing, and bookkeeping",
  "accounting, tax preparation, bookkeeping, and payroll services",
  "activities related to credit intermediation",
  "adhesives and sealants",
  "adjustment and collection services",
  "administration of educational programs",
  "administration of environmental quality programs",
  "administration of general economic programs",
  "administration of human resource programs",
  "administration of public health programs",
  "administration of social and manpower programs",
  "advertising",
  "advertising agencies",
  "advertising, marketing & public relations",
  "advertising, public relations, and related services",
  "aerospace & defense",
  "aerospace product and parts manufacturing",
  "agencies, brokerages, and other insurance related activities",
  "aggregates, concrete & cement",
  "agricultural chemicals",
.....
]

Tips & best practices

Industries are flat (no hierarchy like categories).
Use industryId in Companies — Search and Profiles — Search filters.
Cache this dictionary (changes infrequently).
Prefer CSV export for analytics / BI tools.

Errors

Code	Meaning	How to fix
400	Bad request	Validate query/path.
401	Unauthorized	Provide/refresh Bearer token.
403	Forbidden	Check client permissions; include `X-On-Behalf-Of-User` for CSV.
404	Not found	Industry not found.
429	Rate limit exceeded	Retry with exponential backoff.
500	Internal server error	Retry later; contact support if persistent.