Indexed API

The Indexed API uses API keys for authentication. Pass your key in the X-API-Key header on every request. All requests must be made over HTTPS. Calls without authentication will fail.

API keys start with idx_. Keep keys secret: do not expose them in browser-side code, public repositories, or client bundles. If a key is compromised, revoke it immediately from your API keys dashboard.

curl https://indexed.vc/api/v1/companies?q=stripe \
  -H "X-API-Key: idx_YOUR_KEY_HERE"

1. 1

   Create an API key

   Visit Settings → API Keys and click Create key. Copy the plaintext key immediately — you won't be able to see it again.
2. 2

   Make your first request

   Search for a company by name, industry, or funding amount.

curl https://indexed.vc/api/v1/companies?q=stripe \
  -H "X-API-Key: idx_YOUR_KEY_HERE"

You'll get back a paginated list. By default, results are masked — unrevealed entities return only an opaque ID. Reveal them with POST /reveal (3 credits/entity).

{
  "data": [
    {
      "id": "c5f8-f9a4-…",
      "_masked": true
    },
    {
      "id": "a3b2-18c9-…",
      "name": "Mercury",
      "slug": "mercury",
      "website": "https://mercury.com",
      "short_description": "Banking for startups.",
      "industries": ["fintech", "banking"],
      "hq_country": "United States",
      "total_funding_raised": 152000000,
      "_revealed": true
    }
  ],
  "meta": {
    "total": 247, "page": 1, "limit": 25, "hasMore": true,
    "revealed_count": 1, "masked_count": 1
  }
}

Every response includes headers showing your credit balance:

X-Credits-Cost: 1
X-Credits-Remaining: 1499
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1712345678

Every API call costs credits from your monthly allocation. All tiers use one unified credit pool — the same credits that power profile views, exports, and tech stack reveals in the dashboard.

Entity cache: re-fetching the same entity within 12 months is free. Any paid action on an entity (detail fetch, reveal, UI view) caches it for 12 months — including across endpoints. A company you revealed via POST /reveal will also show as _revealed in subsequent searches.

Out of credits? Enable overage at $0.065/credit in Settings, or buy a credit pack (500 credits for $25, up to 25% off at volume).

Search endpoints return a mix of masked and revealed entities. This is how pricing works at scale: you pay to see each company or investor, and we don't charge you again for entities you've already unlocked.

Each result in the data array is one of two shapes:

The meta block on search responses includes revealed_count and masked_count for the current page, so you know how many new reveals you'd need to unlock everything.

Filter by reveal state with the reveal_status query param:

All values cost 1 credit because the search still hits the database and returns live data. If reveal_status=unrevealed returns zero results, meta includes all_revealed: true as a hint.

# Only return entities you've already revealed (still 1 credit)
curl "https://indexed.vc/api/v1/companies?q=fintech&reveal_status=revealed" \
  -H "X-API-Key: idx_YOUR_KEY_HERE"

Filter companies by the tech stack (languages, frameworks, databases) or app stack (SaaS tools they use) with the techStack and appStack params on GET /companies. This is a premium search — richer intent, higher price.

Pricing: premium searches cost 3 credits on the first page. Pagination within the same filter set is free for 15 minutes via a session token.

The first response includes an X-Search-Session header. Echo it back on subsequent requests with the same filters to paginate at zero cost. Any filter change (including adding a country or funding bound) invalidates the session and charges 3 credits again.

# First page — 3 credits, session token returned
curl -i "https://indexed.vc/api/v1/companies?techStack=React,PostgreSQL&stackMatch=all" \
  -H "X-API-Key: idx_YOUR_KEY_HERE"
# → X-Credits-Cost: 3
# → X-Search-Session: eyJoIjoi…

# Page 2 with session — 0 credits
curl "https://indexed.vc/api/v1/companies?techStack=React,PostgreSQL&stackMatch=all&page=2" \
  -H "X-API-Key: idx_YOUR_KEY_HERE" \
  -H "X-Search-Session: eyJoIjoi…"
# → X-Credits-Cost: 0

Result cap: premium searches return up to 250 matching companies. For very broadly-adopted tools (e.g. AWS, React), the top 250 by relevance are returned. Combine with other filters (industry, country, funding) to narrow the set.

Rate limits are enforced per API key, sliding 60-second window. Limits vary by plan:

Every response includes rate-limit headers. When the limit is exceeded, you'll get a 429 with a Retry-After header.

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1712345678

Errors return a flat JSON shape with a human-readable error message and a machine-readable code. Validation errors include a details array with field-level messages.

{
  "error": "Credits exhausted. Enable overage or purchase a credit pack.",
  "code": "CREDIT_LIMIT_REACHED"
}

// Validation errors include per-field details:
{
  "error": "Invalid query parameters",
  "code": "VALIDATION_FAILED",
  "details": [
    { "field": "limit", "message": "Number must be less than or equal to 100" }
  ]
}

Six endpoints cover the core use cases: searching and fetching companies + investors, revealing masked entities, and a free usage check.

List endpoints return paginated results. Use page and limit to navigate. Every list response includes a meta object with total, page, limit, and hasMore.

{
  "data": [ … ],
  "meta": {
    "total": 3124,
    "page": 1,
    "limit": 25,
    "hasMore": true
  }
}

Maximum page size is 100. To iterate through all results, increment page until hasMore is false.

The API is currently at version v1. We commit to backwards compatibility within a major version: new optional parameters and response fields may be added, but existing fields and behaviors will not break.

Breaking changes ship under a new version path (e.g., /api/v2). We'll announce deprecation at least 6 months before removing a version.