Account research briefs

1. 01Contacts from the company's website

   Emails, phones in E.164, social profiles, and postal addresses the company publishes, each with the page it came from.

   GET /v1/contacts?domain=stripe.com · company

   {
     "name": "Stripe",
     "legal_name": "Stripe, LLC",
     "description": "Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.",
     "logo": "https://images.stripeassets.com/fzn2n1nzq965/1hgcBNd12BfT9VLgbId7By/01d91920114b124fb4cf6d448f9f06eb/favicon.svg",
     "country": "US",
     "language": "en-US"
   }

2. 02Company facts from Crunchbase

   Headquarters, employee range, operating and IPO status, founders, and funding rounds from the public profile.

   GET /v1/organization?engine=crunchbase&permalink=stripe · organization.headquarters

   {
     "city": "South San Francisco",
     "region": "California",
     "country": "United States",
     "continent": "North America"
   }

3. 03Customer and employee ratings

   Trustpilot gives the TrustScore and review count; Glassdoor gives the overall employee rating and CEO approval. Together they show how the company treats both sides.

   GET /v1/company?engine=glassdoor&employer_id=9079&slug=Google · company.ratings

   {
     "overall": 4.4,
     "career_opportunities": 4.2,
     "compensation_and_benefits": 4.5,
     "culture_and_values": 4.2,
     "diversity_and_inclusion": 4.4,
     "senior_management": 3.9,
     "work_life_balance": 4.2,
     "recommend_to_friend_pct": 87,
     "ceo_approval_pct": 83,
     "business_outlook_pct": 82
   }

# One-page account brief from a company's domain and name: what it
# publishes, how employees and customers rate it, and its Crunchbase facts.
import os, requests

API = "https://api.clair.im"
HEADERS = {"Authorization": f"Bearer {os.environ['CLAIR_API_KEY']}"}

def get(path, **params):
    r = requests.get(f"{API}{path}", headers=HEADERS, timeout=90, params=params)
    r.raise_for_status()
    return r.json()

def brief(domain, name, permalink):
    site = get("/v1/contacts", domain=domain, pages=5)
    org = get("/v1/organization", engine="crunchbase", permalink=permalink)["organization"]
    tp = get("/v1/reviews", domain=domain)["business"]
    gd_hit = get("/v1/company/search", engine="glassdoor", q=name)["results"][0]
    gd = get("/v1/company", engine="glassdoor", employer_id=gd_hit["employer_id"],
             slug=gd_hit["slug"])["company"]
    hq = org["headquarters"] or {}
    return {
        "company": org["name"], "hq": f"{hq.get('city')}, {hq.get('country')}",
        "employees": org["employee_range"], "status": org["ipo_status"],
        "founders": [f["name"] for f in org["founders"]],
        "funding_rounds": org["funding"]["num_rounds"],
        "emails": [e["value"] for e in site["emails"] if e["domain_match"]],
        "phones": [p["e164"] for p in site["phones"]],
        "trustpilot": f"{tp['trust_score']} from {tp['review_count']} reviews",
        "glassdoor": f"{gd['ratings']['overall']}, CEO approval {gd['ratings']['ceo_approval_pct']}%",
    }

print(brief("stripe.com", "Stripe", "stripe"))

Set CLAIR_API_KEY to a key subscribed to the Website Contacts API and Crunchbase API and Trustpilot Reviews API and Glassdoor API. Each call is one request against that API's monthly quota.

• Each API is a separate subscription. Start with the two or three that answer your question, not all four.
• Crunchbase needs the permalink and Glassdoor matches on name; check the match for companies with common names.
• Not every company is on Trustpilot or Glassdoor. Handle a 404 or an empty search as no data, not an error.