Company APIs

Company Funders

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

API Key API Secret

Manual credentials take precedence over your account key.

Overview

Look up an investor / fund profile (partners, thesis, check size, recent deals).

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

A positive credit balance is required before each request. 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

403 subscription_required, ip_not_allowed, or insufficient_credits

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"
}