Generate a long list of companies in a defined market, enriched with firmographic, funding and financial data and scored for relevance.
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
The response contains a report_id.Step 2: Track completionUse /api/assets/get_notebook_status/ with the report_id to check whether the report has completed.Step 3: Export resultsOnce 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.
Authorization: Bearer <YOUR_API_TOKEN>
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
POST https://api.wokelo.ai/api/workflow_manager/start/
The request body is JSON. Include advanced_settings in every request and send empty values ("", []) for filters you do not want to apply.
Parameter
Type
Required
Description
topic
string
Required
The market or product category to map (e.g. "warehouse automation").
workflow
string
Required
Must be "agentic_mm".
workbook_name
string
Required
Name of the workbook that holds the generated report.
advanced_settings
object
Optional
Filter parameters. All filters below live inside this object.
advanced_settings.detailed_query
string
Optional
A more descriptive query that refines the market scope.
advanced_settings.companies
string[]
Optional
Permalinks or full URLs of representative companies to anchor the search.
advanced_settings.geography
string[]
Optional
["Worldwide"] for no restriction, or ISO country codes (e.g. ["USA", "GBR"]).
advanced_settings.company_type
string
Optional
"private", "public" or "all".
advanced_settings.employee_count
string[]
Optional
Headcount bands. Empty array includes all. Values: 1-10, 11-50, 51-100, 101-250, 251-500, 501-1000, 1001-5000, 5001-10000, 10000+.
advanced_settings.founded_year
object
Optional
Object with from and/or to (integer years, inclusive).
advanced_settings.funding_stage
string[]
Optional
Empty array includes all. Values: Non-Equity Assistance, Angel round, Pre-seed, Seed, Series A to Series J, Corporate-Funded, Debt-Funded, Private equity round, Others.
advanced_settings.total_funding
object
Optional
Object with from and/or to, in USD.
advanced_settings.total_funding_include_blanks
boolean
Optional
When true, companies with no reported total funding are included.