Dictionary - Industries

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: [email protected] — required only when export=true

---

Example — Get all industries (JSON)

Bash

curl -sS "https://api.salescaddy.ai/api/industries"   -H "Authorization: Bearer $TOKEN"

Node

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

Sample response (trimmed):

JSON

[
  { "id":"ind_hospitality", "name":"Hospitality", "description":"Hotels, lodging, leisure" },
  { "id":"ind_travel", "name":"Travel", "description":"Travel agencies, tour operators" },
  { "id":"ind_airlines", "name":"Airlines", "description":"Passenger air transport" }
]

---

Example — Export industries (CSV)

Bash

curl -sS "https://api.salescaddy.ai/api/industries?export=true"   -H "Authorization: Bearer $TOKEN"   -H "X-On-Behalf-Of-User: [email protected]"   --output industries.csv

Node

import fs from "fs";
const res = await fetch("https://api.salescaddy.ai/api/industries?export=true", {
  headers: { Authorization: `Bearer ${process.env.TOKEN}`, "X-On-Behalf-Of-User":"[email protected]" }
});
const file = fs.createWriteStream("industries.csv");
res.body.pipe(file);

Python

with requests.get("https://api.salescaddy.ai/api/industries",
                  params={"export":"true"},
                  headers={
                    "Authorization": f"Bearer {os.environ['TOKEN']}",
                    "X-On-Behalf-Of-User":"[email protected]"
                  },
                  stream=True) as r:
    with open("industries.csv","wb") as f:
        for chunk in r.iter_content(8192):
            if chunk: f.write(chunk)

C#

http.DefaultRequestHeaders.Add("X-On-Behalf-Of-User","[email protected]");
var bytes = await http.GetByteArrayAsync("https://api.salescaddy.ai/api/industries?export=true");
System.IO.File.WriteAllBytes("industries.csv", bytes);

CSV snippet:

csv

id,name,description
ind_hospitality,Hospitality,Hotels, lodging, leisure
ind_travel,Travel,Travel agencies, tour operators
ind_airlines,Airlines,Passenger air transport

---

Example — Single industry by ID

Bash

curl -sS "https://api.salescaddy.ai/api/industries/ind_hospitality"   -H "Authorization: Bearer $TOKEN"

Node

const res = await fetch("https://api.salescaddy.ai/api/industries/ind_hospitality", {
  headers: { Authorization: `Bearer ${process.env.TOKEN}` }
});
console.log(await res.json());

Python

r = requests.get("https://api.salescaddy.ai/api/industries/ind_hospitality",
                 headers={"Authorization": f"Bearer {os.environ['TOKEN']}"})
print(r.json())

C#

var res2 = await http.GetAsync("https://api.salescaddy.ai/api/industries/ind_hospitality");
Console.WriteLine(await res2.Content.ReadAsStringAsync());

Sample response:

JSON

{ "id":"ind_hospitality", "name":"Hospitality", "description":"Hotels, lodging, leisure" }

---

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.

---