API
Early accessInvestor signals, in your own product.
The same signals, scores and intro paths that power Yellowtail, over a clean REST API with webhooks. Use them in your portal, your CRM or your own tools.
curl https://api.yellowtail.ai/v1/signals \
-H "Authorization: Bearer $YELLOWTAIL_API_KEY" \
-G \
--data-urlencode "sector=climate-hardware" \
--data-urlencode "stage=seed" \
--data-urlencode "region=uk" \
--data-urlencode "since=14d"Response
{
"data": [
{
"id": "sig_9f2c1a",
"type": "intent",
"direction": "toward",
"summary": "Posted about seed climate hardware and asked founders to get in touch.",
"investor": { "id": "inv_4k2m", "name": "Maya Chen", "role": "Partner" },
"fund": { "id": "fnd_81ab", "name": "Northwind Capital", "readiness": "deploying" },
"observed_at": "2026-09-08T09:14:00Z",
"source": { "kind": "social", "url": "https://…", "publisher": "…" },
"weight": 0.86
}
],
"next_cursor": "c_02"
}Everything you see in the app, as data.
investorsPeople who write or influence cheques.
rolefundfocuslast_active
fundsFirms and their funds.
vintagesizereadinessstages
signalsEverything that changed, with a source.
typedirectionobserved_atsource
scoresFit scores for an investor against a company profile.
totalparts[]evidence[]
pathsWarm intro routes to an investor.
viastrengthreason
listsSaved lists and their members, kept up to date.
membersrulesupdated_at
{{CONFIRM endpoint names and fields with the backend before launch}}
Don't poll. Get told.
Subscribe to events and we'll POST them to your endpoint as they happen. Every payload is signed so you can verify it came from us.
- signal.created
- list.member_added
- fund.readiness_changed
- score.threshold_crossed
{
"event": "score.threshold_crossed",
"created_at": "2026-09-08T09:16:22Z",
"data": {
"list_id": "lst_2p9d",
"investor": { "id": "inv_4k2m", "name": "Maya Chen" },
"score": { "total": 84, "previous": 78, "threshold": 80 }
}
}What teams build with it.
Accelerator and studio portals
Give every portfolio company a live, personalised investor list inside the tools your programme already uses.
CRM enrichment
Keep investor records in HubSpot, Attio or Salesforce current with readiness, recent cheques and new signals.
Dashboards and reporting
Pipe signals into your warehouse or BI tool to track which investors are active in your sectors.
Access, limits and security.
- Authentication
- API keys per workspace, scoped read or read/write. Rotate any time.
- Rate limits
- Generous per-minute limits, with higher limits on the API plan. {{TODO: numbers}}
- Usage
- Calls draw from a monthly credit pool shared with Yellowtail MCP.
- Data handling
- Encrypted in transit and at rest. {{CONFIRM: region, sub-processors, DPA availability}}
FAQ
Which plan includes the API?
The API plan. It also includes everything in Platform. Compare plans
Can I get historical signals?
Yes, historical export is included on the API plan. {{CONFIRM: how far back}}
Is there a sandbox?
{{CONFIRM}}
Can I resell the data?
Not as raw data. Embedding it in your own product for your users is what the API plan is for. Talk to us about your use.
REST or GraphQL?
REST with JSON, cursor pagination and webhooks.