Skip to main content

1. Overview

The Market Map API generates a long list of companies operating in a defined market, enriched with firmographic, funding and financial data. Given a market topic (e.g. “warehouse automation”) and optional filters, the AI pipeline evaluates each candidate against the market thesis and returns a list with relevance scores and per-company commentary. 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 company includes firmographics, product profile, funding and headcount, financials (for public companies), M&A history, an Overall Score (1 to 10) and a Commentary explaining its relevance to the market. Common use cases:
  • Deal sourcing: build a scored target universe for a vertical or thesis
  • Corporate strategy and M&A: map the landscape for a market entry or build-vs-buy analysis
  • Market research: generate an exhaustive vendor set for benchmarking

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 market map

Private warehouse automation companies in the USA and UK, 51 to 250 employees, Series A or B, with $1M to $50M total funding.