Competitor List

import time

while True:
    status_resp = requests.get(
        f"https://api.wokelo.ai/api/enterprise/request/{request_id}/status/",
        headers={"Authorization": "Bearer <YOUR_API_TOKEN>"}
    )
    status = status_resp.json()["status"]
    if status == "COMPLETED":
        break
    elif status == "FAILED":
        raise Exception("Job failed")
    print(f"Status: {status} — waiting...")
    time.sleep(5)

result_resp = requests.get(
    f"https://api.wokelo.ai/api/enterprise/request/{request_id}/result/",
    headers={"Authorization": "Bearer <YOUR_API_TOKEN>"}
)
peers = result_resp.json()["result"]
for p in peers:
    print(p["Name"], "—", p.get("Product Category"), "— Score:", p.get("Overall Score"))

Authorization: Bearer <YOUR_API_TOKEN>

POST https://api.wokelo.ai/api/enterprise/company-peers/enrich/

{
  "request_id": "450c0d25-c83b-4fc7-8713-f96b63db7843",
  "status": "PENDING"
}

{
  "request_id": "450c0d25-c83b-4fc7-8713-f96b63db7843",
  "status": "COMPLETED",
  "result": [ ...peer objects... ]
}

{
  "request_id": "450c0d25-c83b-4fc7-8713-f96b63db7843",
  "status": "COMPLETED",
  "result": [
    {
      "Permalink": "horizon-services",
      "Name": "Horizon Services",
      "Website": "horizonservices.com",
      "HQ City": "Wilmington",
      "HQ Country": "United States",
      "Founded": "1987",
      "Type": "Private",
      "Operating Status": "Acquired",
      "Product Category": "Residential Plumbing HVAC Services",
      "Core Offering": "Horizon Services provides plumbing, heating, and air conditioning services, including installation, maintenance, and repair, primarily for residential customers.",
      "Employees (Crunchbase)": "501-1000",
      "Employees (LinkedIn)": 446,
      "Acquisitions": "Hutchinson Plumbing Heating Cooling (2020), Casteel (2017), Gold Medal Service (2017)",
      "Overall Score": 9.0,
      "Commentary": "Horizon Services primarily delivers residential plumbing, heating, and air conditioning services, including installation, maintenance, and repair, plus drain cleaning and sewer repair. This maps closely to Del-Air's HVAC and home services model with strong evidence of direct residential service operations and regional leadership in that category."
    },
    {
      "Permalink": "the-wrench-group",
      "Name": "Wrench Group",
      "Website": "wrenchgroup.com",
      "HQ City": "Marietta",
      "HQ Country": "United States",
      "Founded": "2015",
      "Type": "Private",
      "Operating Status": "Acquired",
      "Product Category": "Home Repair Maintenance Services",
      "Funding Stage": "Debt-Funded",
      "Total Funding": 1300000000.0,
      "Key Investors": ["Oak Hill Capital Partners", "Crescent Capital Group", "TSG Consumer Partners", "Blue Owl"],
      "Acquisitions": "Lindstrom Air Conditioning & Plumbing (2024), Superior Service (2022), Nexgen (2022), Buckeye Heating & Cooling (2021), Williams Comfort Air (2021)",
      "Overall Score": 9.0,
      "Commentary": "Wrench Group primarily provides residential home repair, replacement, and maintenance services specializing in HVAC, plumbing, and electrical, including heating and air conditioning installation, repair, and maintenance. Its multi-brand, direct-to-consumer model and emergency/service-center approach align closely with Del-Air's core residential HVAC and related home services across major U.S. metros."
    }
  ]
}

import requests

response = requests.post(
    "https://api.wokelo.ai/api/enterprise/company-peers/enrich/",
    headers={
        "Authorization": "Bearer <YOUR_API_TOKEN>",
        "Content-Type": "application/json"
    },
    json={
        "company": "crowdstrike",
        "parameters": {
            "detailed_query": "Public cybersecurity platforms covering endpoint protection, XDR, and cloud security",
            "company_type": "public",
            "revenue": {"from": 200000000}
        }
    }
)
print(response.json()["request_id"])

import requests

response = requests.post(
    "https://api.wokelo.ai/api/enterprise/company-peers/enrich/",
    headers={
        "Authorization": "Bearer <YOUR_API_TOKEN>",
        "Content-Type": "application/json"
    },
    json={
        "company": "del-air",
        "parameters": {
            "detailed_query": "Regional residential HVAC and plumbing contractors suitable for roll-up consolidation",
            "geography": ["USA"],
            "company_type": "private",
            "employee_count": ["51-100", "101-250", "251-500"],
            "total_funding": {"to": 50000000}
        }
    }
)
print(response.json()["request_id"])

# Without detailed_query: returns broad set of "Amazon-like" companies
# With detailed_query: returns peers specifically in cloud infrastructure
import requests

response = requests.post(
    "https://api.wokelo.ai/api/enterprise/company-peers/enrich/",
    headers={
        "Authorization": "Bearer <YOUR_API_TOKEN>",
        "Content-Type": "application/json"
    },
    json={
        "company": "amazon",
        "parameters": {
            "detailed_query": "Public cloud infrastructure and platform providers (IaaS/PaaS), not retail or marketplaces",
            "sample_companies": ["microsoft-azure", "google-cloud"],
            "company_type": "public"
        }
    }
)
print(response.json()["request_id"])

{
  "status": "error",
  "detail": "Company permalink 'unknown-co' could not be resolved."
}

import requests, time

def poll_until_done(request_id, headers, interval=5, timeout=600):
    elapsed = 0
    while elapsed < timeout:
        resp = requests.get(
            f"https://api.wokelo.ai/api/enterprise/request/{request_id}/status/",
            headers=headers
        ).json()
        status = resp["status"]
        if status == "COMPLETED":
            return True
        elif status == "FAILED":
            raise Exception(f"Job {request_id} failed: {resp.get('detail', 'unknown error')}")
        time.sleep(interval)
        elapsed += interval
    raise TimeoutError(f"Job {request_id} did not complete within {timeout}s")