Nyne.ai API Login
Company APIs

Investor API for Fund Profiles

Retrieve a profile for an investment firm, VC fund, or angel investor - partners, investment thesis, typical check size, the rounds they invest in, portfolio locations, and recent investments. Supply at least one of company_name or company_domain (the investor’s name/domain - prefer the domain when available, it gives the strongest match). The request is queued asynchronously and returns a request_id; poll the status endpoint or supply a callback_url. Result arrays are bounded - up to 20 partners, 5 investment_locations, and 5 recent_investments - and fields with no data are omitted. A credit is charged only when investor data is found.

POST https://api.nyne.ai/company/funders API key

Manual credentials take precedence over your account key.

Overview

The Investor API looks up investor or fund profiles, giving applications structured context on partners, thesis, check size, and recent deal activity.

Best for

  • Researching investors
  • Enriching fund profiles
  • Mapping venture and funding relationships

Returns

  • Investor or fund profile
  • Partner and thesis context
  • Recent deal metadata

Parameters

company_name string optional
Investor name to look up, e.g. “Y Combinator”, “Sequoia Capital”. Required unless company_domain is supplied. Max 255 chars.
company_domain string optional
Investor domain to look up, e.g. “sequoiacap.com”, “a16z.com”. Required unless company_name is supplied. Max 255 chars.
callback_url string optional
http(s) URL on an allowed host that receives the completed payload automatically.

Polling for the result

This endpoint is asynchronous. A successful submit returns a request_id while the job runs in the background. Poll the same path with a GET request - same authentication headers - passing the request_id as a query parameter:

Loading your API credentials...

Each poll returns the job's current status; once it is completed the payload carries the result shown under Responses. Polling an unknown or expired request_id returns 404 request_not_found.

Status Meaning
queued · processing · pending The job is still running - keep polling.
completed The job finished; the payload carries the result and completed: true.
failed Terminal - the job could not complete; the error field explains why.

Poll every few seconds at first, backing off for long-running jobs. Polling is free - status checks never burn credits.

Prefer push delivery?
Supply the optional callback_url parameter and the completed payload is POSTed to your endpoint when the job finishes - no polling required. Delivery is retried up to 5 times with exponential backoff (1s, 5s, 15s, 1m, 5m) and a 30-second timeout per attempt; respond with a 2xx status to acknowledge receipt.

Credit usage

Credits are charged based on the matched configuration. The listed cost is the per-result unit price.

Feature Credits Notes
Investor Lookup - Charged once when investor data is retrieved
No data 0 No investor found never burns credits
Heads up
Empty results do not burn credits.

Responses

202 Investor lookup queued - poll the status endpoint with the returned request_id
400 missing_parameters / invalid_parameters / invalid_callback_url
401 Missing or invalid API credentials
402 insufficient_credits
403 subscription_required or ip_not_allowed
404 no funder data found (no credit charged)
429 rate_limit_exceeded / monthly_limit_exceeded
503 service_unavailable - the API is temporarily unavailable

A successful response wraps the payload in the { success, data, timestamp } envelope (also shown live in the panel on the right):

{
  "success": true,
  "data": {
    "request_id": "64f2d8e4fr1f065a9b4e7fbc3df6aabb_1700000123_6610",
    "status": "completed",
    "completed": true,
    "result": {
      "investor_name": "Y Combinator",
      "investor_domain": "ycombinator.com",
      "location": "Mountain View, CA, US",
      "investment_thesis": "Backs early-stage startups at the idea / seed stage.",
      "partners": [
        {
          "name": "Garry Tan",
          "linkedin_url": "https://www.linkedin.com/in/garrytan/"
        }
      ],
      "average_check_size": {
        "low": 125000,
        "high": 500000,
        "currency": "USD"
      },
      "rounds_they_invest_in": [
        "pre_seed",
        "seed"
      ],
      "recent_investments": [
        {
          "company_name": "Example Startup",
          "company_domain": "example.com",
          "amount": 500000,
          "currency": "USD"
        }
      ]
    },
    "completed_on": "2026-01-15T10:35:00Z"
  },
  "timestamp": "2026-01-01T00:00:00"
}