Use AI to summarize a company’s technology stack from a natural‑language prompt or an explicit domain.
Great for quick discovery and hypothesis generation — then verify deterministically with standard endpoints.

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

Endpoint

POST /ai/find-techstacks-for-company

Headers

Authorization: Bearer <token> — required
X-On-Behalf-Of-User: you@yourcompany.com — required (AI actions are attributed to a user)

Query parameters

Name	Type	Required	Default	Description
`prompt`	string	No*	—	Natural-language question (e.g., "What tech stack does Hilton use?")
`companyDomain`	string	No*	—	Domain to focus on (e.g., `hilton.com`)
`size`	int	No	20	Max number of stack items

Provide either prompt or companyDomain (or both).

Response (illustrative, trimmed)

[
  {
    "software": "Hilton Honors App",
    "reason": "Customer-facing mobile application and booking engine. Custom-built software product essential for direct bookings and digital key functionality.",
    "source": "Official App Store listings, Hilton website.",
    "probability": 100,
    "dateFirstVerified": "2024-05-20T10:00:00Z",
    "dateLastVerified": "2024-05-20T10:00:00Z"
  },
  {
    "software": "LightStay",
    "reason": "Proprietary software platform for corporate responsibility, sustainability tracking, and operational efficiency reporting.",
    "source": "Official Hilton website 'ESG' section, public reports.",
    "probability": 98,
    "dateFirstVerified": "2024-05-20T10:00:00Z",
    "dateLastVerified": "2024-05-20T10:00:00Z"
  },
  {
    "software": "OnQ",
    "reason": "Proprietary Property Management System (PMS) and Central Reservation System (CRS). Core operational software used across all properties.",
    "source": "Historical press releases, internal documentation, employee training materials.",
    "probability": 95,
    "dateFirstVerified": "2024-05-20T10:00:00Z",
    "dateLastVerified": "2024-05-20T10:00:00Z"
  },
  {
    "software": "Cvent Event Marketing & Management",
    "reason": "Used for managing events, meetings, and group bookings, essential for a large hotel chain.",
    "source": "BuyerCaddy (HILTON MEXICO/hilton.com)",
    "probability": 95,
    "dateFirstVerified": "2002-06-09T00:00:00Z",
    "dateLastVerified": "2025-11-25T00:00:00Z"
  },
.....
]

⚠️
AI results are probabilistic. Always confirm with deterministic endpoints:

GET /companies/{domain}/products/paged or CSV/JSONL variants.

POST /companies/{domain}/products-in-use for specific productIds.

GET /companies/{domain}/cohort/{cohort}/metrics/usage for benchmarking.

Example — Prompt only

curl -sS -X POST "https://api.salescaddy.ai/api/ai/find-techstacks-for-company?prompt=What%20tech%20stack%20does%20Hilton%20use%3F&size=15"   
-H "Authorization: Bearer $TOKEN"   
-H "X-On-Behalf-Of-User: you@yourcompany.com"

const url = "https://api.salescaddy.ai/api/ai/find-techstacks-for-company?prompt=What%20tech%20stack%20does%20Hilton%20use%3F&size=15";
const res = await fetch(url, { method: "POST", headers: {
  Authorization: `Bearer ${process.env.TOKEN}`,
  "X-On-Behalf-Of-User": "you@yourcompany.com"
}});
console.log(await res.json());

import os, requests
r = requests.post("https://api.salescaddy.ai/api/ai/find-techstacks-for-company",
                  params={"prompt":"What tech stack does Hilton use?","size":15},
                  headers={"Authorization": f"Bearer {os.environ['TOKEN']}",
                           "X-On-Behalf-Of-User": "you@yourcompany.com"})
print(r.json())

using System.Net.Http.Headers;
var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", TOKEN);
http.DefaultRequestHeaders.Add("X-On-Behalf-Of-User","you@yourcompany.com");
var res = await http.PostAsync("https://api.salescaddy.ai/api/ai/find-techstacks-for-company?prompt=What%20tech%20stack%20does%20Hilton%20use%3F&size=15", null);
Console.WriteLine(await res.Content.ReadAsStringAsync());

Example — Explicit company domain

curl -sS -X POST "https://api.salescaddy.ai/api/ai/find-techstacks-for-company?companyDomain=hilton.com&size=20"   -H "Authorization: Bearer $TOKEN"   -H "X-On-Behalf-Of-User: you@yourcompany.com"

const url = "https://api.salescaddy.ai/api/ai/find-techstacks-for-company?companyDomain=hilton.com&size=20";
const res = await fetch(url, { method: "POST", headers: {
  Authorization: `Bearer ${process.env.TOKEN}`,
  "X-On-Behalf-Of-User": "you@yourcompany.com"
}});
console.log(await res.json());

r = requests.post("https://api.salescaddy.ai/api/ai/find-techstacks-for-company",
                  params={"companyDomain":"hilton.com","size":20},
                  headers={"Authorization": f"Bearer {os.environ['TOKEN']}",
                           "X-On-Behalf-Of-User": "you@yourcompany.com"})
print(r.json())

var res2 = await http.PostAsync("https://api.salescaddy.ai/api/ai/find-techstacks-for-company?companyDomain=hilton.com&size=20", null);
Console.WriteLine(await res2.Content.ReadAsStringAsync());

Good prompts

“List the data engineering stack used by Marriott.”
“What observability tools do US airlines use?”
“Which collaboration tools are common at European hotel chains?”

Post‑processing (verification & enrichment)

Verify candidates: GET /companies/{domain}/products/paged and/or POST /companies/{domain}/products-in-use.
Benchmark with GET /companies/{domain}/cohort/{cohort}/metrics/usage.
Drill down to product details via Products — Search / Vendor Products.

Errors

Code	Meaning	How to fix
400	Bad request	Provide `prompt` or `companyDomain`; validate `size` (positive int).
401	Unauthorized	Provide/refresh Bearer token.
403	Forbidden	Include `X-On-Behalf-Of-User`; ensure your plan permits AI usage.
404	Not found	No stack candidates found for the request.
429	Rate limit exceeded	Retry with exponential backoff; respect `Retry-After`.
500	Internal server error	Retry later; contact support if persistent.