API

Early access

Investor 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.

Docs available on request {{TODO: docs URL}}
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"
}
Illustrative example. Fictional investor.

Everything you see in the app, as data.

  • investors

    People who write or influence cheques.

    rolefundfocuslast_active

  • funds

    Firms and their funds.

    vintagesizereadinessstages

  • signals

    Everything that changed, with a source.

    typedirectionobserved_atsource

  • scores

    Fit scores for an investor against a company profile.

    totalparts[]evidence[]

  • paths

    Warm intro routes to an investor.

    viastrengthreason

  • lists

    Saved 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 }
  }
}
Illustrative example. Fictional investor.

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.

Build on the freshest investor data.

See API plan →

Vetted founders only · We reply within 48h