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.
1. Overview
The Fundraise Activity API gives you programmatic access to Wokelo’s curated database of funding rounds and investment events for a given report. Each record surfaces the full round context: which company raised, at what stage, from which investors, on what date, what the company does, and relevant news coverage — all structured and ready to query. This is a synchronous API — submitting a request returns the complete result set immediately. No polling is required. Each funding record in the result set includes:- Round metadata — funding date, stage, disclosed amount, and lead and other investors
- Company firmographics — headquarters, founding year, employee count, and operating geography
- Company business profile — product category, core offering description, and product catalog
- News context — curated coverage excerpts with source URLs for rounds with public reporting
- Deal origination and market intelligence — Track which investors are most active in a sector. Identify emerging companies attracting capital before they become widely known
- Investor profiling — Map which VCs, corporate strategists, and institutional funds are backing companies in a given product category or geography
- Competitive landscape analysis — Monitor funding velocity in your market. A cluster of seed rounds signals early-stage activity; a wave of Series B and C rounds signals rapid scaling
- Portfolio monitoring — Catch new funding events in categories you track. Filter by stage to surface only the events relevant to your thesis
- LP and fund research — Identify sector specialists and prolific lead investors by aggregating round-level data across a report
- Startup scouting — Surface pre-seed and seed companies in niche product categories before they appear on mainstream databases
This API is synchronous. A single POST request returns the complete funding round data immediately — no job polling required. See How Sync APIs work.
2. Quick Start
Step 1 — Submit the request3. Authentication
All requests must include a Bearer token in theAuthorization HTTP header. No other authentication method is supported.
4. Request Reference
Endpointreport_id is the only required parameter.
| Parameter | Type | Required | Description |
|---|---|---|---|
report_id | integer | Required | The unique identifier for the fundraise report you want to retrieve. Find this in the URL when viewing a report in the Wokelo dashboard (app.wokelo.ai/reports/<report_id>) or via the Reports API. |
5. Response
Response structure
| Field | Type | Description |
|---|---|---|
Grid | object | Contains one key (a workflow identifier string) whose value is an array of funding round objects. Use list(data["Grid"].values())[0] to extract the array. |
meta.report_id | integer | The report ID that was requested. |
meta.title | string | Human-readable title of the report. |
meta.user | string | Email of the Wokelo user who created the report. |
meta.dt_createdon | string | ISO 8601 datetime when the report was generated. |
Funding round object fields
Each object in the records array represents a single funding event. A company with multiple rounds will appear once per round. Round identity| Field | Type | Description |
|---|---|---|
Permalink | string | Stable Wokelo company identifier (e.g. "clarifruit", "apeel-sciences"). Use this as a company key — the same Permalink appears across multiple rounds for the same company. |
Funding Date | string | ISO 8601 date when the round was announced or closed (YYYY-MM-DD). |
Funding Stage | string | Round classification. See Funding Stage values below. |
Funding Amount ($M) | float | null | Total round size. Null when undisclosed. See the note on units below. |
| Field | Type | Description |
|---|---|---|
Lead Investor(s) | string[] | null | Array of lead investor names for this round. Null when no lead was identified or the round has no lead. |
Other Investor(s) | string[] | null | Array of non-lead participating investors. Null when none were identified. |
| Field | Type | Description |
|---|---|---|
Name | string | Display name of the company that raised. |
Website | string | null | Primary domain of the company (e.g. "clarifruit.com"). |
HQ City | string | null | Headquarters city of the company. |
HQ Country | string | null | Headquarters country of the company. |
HQ Continent | string | null | Headquarters continent of the company. |
Founded | string | null | Year the company was founded. |
Employees (Crunchbase) | string | null | Employee headcount band from Crunchbase (e.g. "11-50"). |
Employees (LinkedIn) | integer | null | Numeric employee count from LinkedIn. |
| Field | Type | Description |
|---|---|---|
Product Category | string | null | Short label for the company’s primary product or service category (e.g. "Produce Quality Data Platform"). |
Core Offering | string | null | AI-generated 2–4 sentence description of what the company does, its customers, and its market position. |
Product Catalog | string | null | Comma-separated list of key products and services. |
| Field | Type | Description |
|---|---|---|
News | string | null | Concatenated news coverage for the funding event. Each section contains a prose summary followed by a source URL on a new line. Multiple coverage items are separated by blank lines. Null when no coverage was indexed. |
The
News field is unstructured text, not JSON. Parse it by splitting on newlines and identifying lines that start with http to extract source URLs separately from prose summaries.Funding Stage values
TheFunding Stage field uses the following standardised values:
| Stage | Description |
|---|---|
Pre-seed | Very early capital, often friends, family, or micro-funds |
Seed | First institutional round |
Series A through Series J | Labelled venture equity rounds |
Series Unknown | A round was confirmed but the series label was not publicly disclosed |
Angel round | Investment from individual angel investors |
Equity Crowdfunding | Capital raised from retail investors via a crowdfunding platform |
Product Crowdfunding | Campaign-style fundraise (e.g. Kickstarter) |
Convertible note | Debt that converts to equity at a future event |
Non-Equity Assistance | Accelerator programmes, grants-in-kind, or advisory support with no direct equity exchange |
Grant | Non-dilutive funding from government bodies, foundations, or innovation programmes |
Debt-Funded | Venture debt, revenue-based financing, or other loan structures |
Private equity round | Growth equity or buyout investment from a PE firm |
Corporate-Funded | Strategic investment from a corporate venture arm or operating company |
Secondary Market | Sale of existing shares between investors (no new capital to the company) |
Post IPO Equity | Follow-on equity offering after a public listing |
Post IPO Debt | Debt issuance after a public listing |
Post IPO Secondary | Secondary share sale after a public listing |
Undisclosed | Funding confirmed but stage and amount are not publicly available |
Funding Amount units
TheFunding Amount ($M) field is labelled in millions but stored values are in raw USD. A round reported as “$12 million” is stored as 12000000.0. Always convert before displaying:
Notes on null values
Several fields are frequently null, and this is expected:Funding Amount ($M)— Many rounds are not publicly disclosed. Null means undisclosed, not zero.Lead Investor(s)— Null for rounds with no named lead, grants, debt rounds, and crowdfunding events.Other Investor(s)— Null when investor participation was not reported beyond the lead.Product CategoryandCore Offering— Null for companies where Wokelo’s enrichment pipeline did not find sufficient public information.News— Null when no news coverage was indexed for the event.
Multiple records per company
A single company can appear many times in the result set, once per funding event. For example,"hectre" has ten separate records across Seed, Convertible note, Grant, Series A, and Non-Equity Assistance rounds. Use the Permalink field to group all rounds for a given company:
6. Examples
Retrieving and filtering a full report
Retrieve all funding records in a report and filter to disclosed Series A rounds and above.Building a full funding history per company
Since each company can have multiple records, group byPermalink to reconstruct the complete financing timeline for each company.
Profiling the most active investors
Identify which investors appear most frequently across all rounds — useful for targeting warm introductions or understanding who controls the capital in a sector.Filtering by funding stage
Isolate grant and non-dilutive rounds to track government and foundation funding in a sector — distinct from venture activity.7. Error Handling
The API uses standard HTTP status codes. All error responses include a JSON body with adetail or message field.
| Status | Meaning | Cause & Resolution |
|---|---|---|
200 OK | Success | Results returned successfully. |
400 Bad Request | Invalid parameters | A required field is missing or a parameter value is invalid — e.g. missing report_id or a non-integer value. Check the detail field. |
401 Unauthorized | Auth failed | The Authorization header is missing, malformed, or contains an invalid token. Verify your key in Settings → API Keys. |
403 Forbidden | Insufficient access | Your plan does not include access to this endpoint or report. Contact support@wokelo.ai to review your plan. |
404 Not Found | Resource not found | The report_id does not exist or is not accessible to your account. Confirm the ID in your dashboard. |
429 Too Many Requests | Rate limit exceeded | Implement exponential back-off. The response includes a Retry-After header. |
500 Internal Server Error | Server error | Retry after a brief delay. If the issue persists, contact support@wokelo.ai with your report_id. |
8. Best Practices
UsePermalink as the company key — not Name
The same company can appear many times across different funding rounds. Always group by Permalink, not Name, to avoid creating duplicates when building company-level aggregations:
Lead Investor(s) and Other Investor(s) are arrays but may be null — not empty arrays — when no investor data was available. Guard before iterating:
Funding Amount ($M) unit quirk
Despite the field name suggesting millions, the stored values are raw USD. Always convert before displaying or aggregating:
News field as structured text
The News field is a multi-section string, not JSON. Each section contains a prose summary followed by a source URL. Parse it by splitting on newlines:
Funding Stage field mixes venture equity rounds with grants, debt, and non-equity assistance. When computing total capital raised or building investor lists, filter to the stage types relevant to your analysis:
9. Related APIs
M&A Activity
Retrieve structured deal data for a market — acquirer profiles, target details, deal amounts, and news context.
Market Map
Discover and map all companies competing in a specific market or product category.
Target Screening
Identify and score potential acquisition targets for a defined acquirer — AI-ranked with deal feasibility and synergy scores.
Buyer Screening
Identify and score potential acquirers for a target company — the inverse of Target Screening.
Company Deep Intelligence
Generate deep AI intelligence on any company — business model, financials, strategy, and funding history.
Company Instant Enrichment
Synchronously enrich firmographic and financial data for any company in the funding dataset.