Skip to main content
POST
/
api
/
enterprise
/
company-peers
/
enrich
Competitor List
curl --request POST \
  --url https://api.wokelo.ai/api/enterprise/company-peers/enrich/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": "del-air",
  "parameters": {
    "detailed_query": "Residential home services companies",
    "sample_companies": [
      "service-titan",
      "angi"
    ],
    "geography": [
      "USA"
    ],
    "company_type": "private",
    "employee_count": [],
    "founded_year": {},
    "funding_stage": [],
    "total_funding": {},
    "last_funding_round": {},
    "revenue": {},
    "ebitda": {},
    "net_income": {},
    "ev_ebitda": {}
  }
}
'
{
    "request_id": "450c0d25-c83b-4fc7-8713-f96b63db7843",
    "status": "PENDING"
}

Documentation Index

Fetch the complete documentation index at: https://docs.wokelo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Competitor List API generates a long list of companies similar to the given company, enriched with structured data. Optionally, you can refine the output by specifying sample companies, geography, company type, employee count, funding stage, and more. Returns request_id as a response.

​
Endpoint Details

  • Method: POST
  • Endpoint: /api/enterprise/company-peers/enrich/

​
Authentication Requirements

  • Include a valid JWT token in your request header
  • If you don’t have a token yet, you can get one from the /auth/token/ endpoint first.

​
Request

​
Header Parameters

​
Authorization
string
required
JWT token obtained from the Authentication request

​
Body Parameters

​
company
string
required
URL or permalink of the company whose peers need to be found (e.g. "del-air")
​
parameters
object
Filter parameters object. All fields inside are optional, but must always be included in the request body — send empty values ("", [], {}) for any fields you do not want to filter on.
​
detailed_query
string
A more descriptive query to refine the search scope.
​
sample_companies
string[]
Permalinks of representative companies or their complete URLs.
​
geography
string[]
Geographic scope as ISO country codes. (e.g. ["USA", "GBR"])
​
company_type
string
Type of company to include. Accepted values: "private", "public", "all"
​
employee_count
string[]
Filter by employee headcount range. Pass an empty array to include all headcounts.Supporting array values: 1-10, 11-50, 51-100, 101-250, 251-500, 501-1000, 1001-5000, 5001-10000, 10000+
​
founded_year
object
Filter by company founding year.
​
from
integer
Minimum founding year (inclusive), e.g. 2010
​
to
integer
Maximum founding year (inclusive), e.g. 2020
​
funding_stage
string[]
Filter by funding stage (e.g. "Series A", "Series B"). Pass an empty array to include all stages.Supporting array values: Non-Equity Assistance, Angel round, Pre-seed, Seed, Series A, Series B, Series C, Series D, Series E, Series F, Series G, Series H, Series I, Series J, Corporate-Funded, Debt-Funded, Private equity round, Others
​
total_funding
object
Filter by total funding amount raised (in USD).
​
from
number
Minimum total funding in USD, e.g. 1000000
​
to
number
Maximum total funding in USD, e.g. 50000000
​
last_funding_round
object
Filter by last funding round amount (in USD).
​
from
number
Minimum last funding round in USD, e.g. 500000
​
to
number
Maximum last funding round in USD, e.g. 20000000
​
revenue
object
Filter by annual revenue (in USD).
​
from
number
Minimum annual revenue in USD, e.g. 500000
​
to
number
Maximum annual revenue in USD, e.g. 10000000
​
ebitda
object
Filter by EBITDA (in USD).
​
from
number
Minimum EBITDA in USD
​
to
number
Maximum EBITDA in USD
​
net_income
object
Filter by net income (in USD).
​
from
number
Minimum net income in USD
​
to
number
Maximum net income in USD
​
ev_ebitda
object
Filter by EV/EBITDA multiple.
​
from
number
Minimum EV/EBITDA multiple
​
to
number
Maximum EV/EBITDA multiple

​
Response

A successful response returns a request_id that can be used to track the status of the request.

​
Successful Response Fields

​
request_id
string
Unique identifier for the request posted. Use this with the /api/enterprise/request/status/ endpoint to check the status
{
    "request_id": "450c0d25-c83b-4fc7-8713-f96b63db7843",
    "status": "PENDING"
}

Authorizations

​
Authorization
string
header
required

JWT token obtained from the /auth/token/ endpoint.

Body

application/json
​
company
string
required

URL or permalink of the company whose peers need to be found.

Example:

"del-air"

​
parameters
object

Optional filter parameters. All fields must always be included in the request body — send empty values for any fields you do not want to filter on.

Response

202 - application/json

Request accepted

​
request_id
string<uuid>
Example:

"931643e9-b6c7-45d4-9ba9-bd3b534221e7"

​
status
enum<string>
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
Example:

"PENDING"