Skip to main content

1. Overview

The Competitor List API generates a ranked list of companies similar to a given seed company, enriched with firmographic, funding and financial data. Given a company permalink and optional refinements, the AI pipeline evaluates each candidate against the seed company’s product, customers and business model. Unlike Market Map, which starts from a market topic, Competitor List starts from a specific company. This is an asynchronous API. Starting the workflow returns a report_id, which you use to track completion and export the results. See How Async APIs work. Each peer includes firmographics, product profile, funding and headcount, financials (for public companies), M&A history, an Overall Score (1 to 10) measuring similarity to the seed company, and a Commentary explaining the overlap. Common use cases:
  • Competitive intelligence: build a vendor landscape around a specific company
  • Peer benchmarking: identify comparables for valuation or KPI analysis
  • Roll-up sourcing: find players similar to a platform company for bolt-on consolidation

2. Quick Start

Step 1: Start the workflow
The response contains a report_id. Step 2: Track completion Use /api/assets/get_notebook_status/ with the report_id to check whether the report has completed. Step 3: Export results Once the report is complete, use /api/assets/download_report/ with the report_id to export the results.

3. Authentication

Include a Bearer token in the Authorization header of every request.
Obtain a token from the /auth/token/ endpoint using the client id and client secret under Account Details → API Credentials in the Wokelo dashboard. Contact support@wokelo.ai if you do not yet have API access.
Never expose your token in client-side code or public repositories.

4. Request Reference

Endpoint
The request body is JSON. Include advanced_settings in every request and send empty values ("", []) for filters you do not want to apply.

5. Response

Workflow start response

Report output fields


6. Examples

Filtered peer set

Private AI legal technology peers of Harvey in the USA and UK, 51 to 250 employees, Series A or B, with $1M to $50M total funding.