Documentation
Documentation

Overview

Spore docs

Start here

Getting startedInstall the CLIAuthentication and keys

Build

Search and filtersSegments and the loopEnrichment lifecycle

Recipes

Recipe: search to a live SegmentRecipe: enrich without a segmentRecipe: land your own research

Connect

Events

Account

Credits and billing

Reference

Conventions
API reference

Spore docs

Agent-first B2B company intelligence — a live registry, saved segments, and your organization's own knowledge, over one contract served as REST at /api/v1.

Spore is company intelligence built for agents to operate, not just for people to read. A live registry of companies you can filter; saved segments you can narrow into a tree and export; your organization's own knowledge landed back onto the same records; and enrichment tools that fill the gaps. One contract serves all of it, as REST at /api/v1. The reference pages and the agent guide are generated from that same contract, so an agent that can read this reference can drive the product.

Quickstart

Mint a key in the dashboard under Organization → Access → Create API Key. It is shown once. Then every call carries it:

export SPORE_API_KEY=spore_sk_...

curl https://www.spore.ee/api/v1/catalog?section=tools \
  -H "Authorization: Bearer $SPORE_API_KEY"

GET /api/v1/catalog?section=tools is free and takes no request body — it lists every workflow a key can run, with the JSON Schema for its request body and its credit cost. That makes it the natural first call for an agent that has just been handed a key.

The first call that does real work is a search. Ask how many Estonian companies exist and what they look like in aggregate:

curl -X POST https://www.spore.ee/api/v1/search \
  -H "Authorization: Bearer $SPORE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-search-1" \
  -d '{"filter":{"type":"group","logic":"AND","children":[{"type":"rule","fieldId":"countryCode","operator":"in","value":["EE"]}]},"sortBy":"revenue","sortOrder":"desc","maxCredits":5}'

Reading the docs is free. Running a request is not — the try-it playground on every operation page posts to the real /api/v1 route with your key and your credits.

What do you want to do?

You wantCall
Find companies matching criteriasearch
Unlock every match of a searchsearch-unlock
Keep a live population and refine its filtersegment-create, segment-update, segment-companies
Fill data gaps (domains, contacts, research)enrich
Write your own findings onto recordsrecord
Read one companycompany, lookup
Check money: balance, bounds, ledgerwallet, wallet-transactions
Discover the vocabulariescatalog

Anything that costs compute answers with a launch you poll — that pattern, and the envelope, lifecycle, outcomes, cursors and rate limit every operation shares, are in Conventions.

Guides

Getting startedMint a key, make your first call, and find where to go next.Authentication and keysBearer auth, capability scopes, spend bounds, and the refusals they produce.Search and filtersThe filter AST, the field vocabulary, canonical hashing and free replay.Segments and the loopName a live filter, page its members, enrich Companies, and land knowledge.Enrichment lifecycleLifecycle, the five outcomes, polling, partial failure, cancellation and refunds.ConventionsThe envelope, lifecycle, outcomes, rate limit, cursors, ETags, idempotency, and the async pattern.EventsFollow durable organization events over a resumable SSE stream.Credits and billingWhat each call costs, what is free, and how variable prices are quoted.

Recipes

Search to a live SegmentSearch the Commons, unlock the population, then read your Companies and Segment.Enrich without a segmentRun a tool against up to 50,000 specific unlocked ids you name outright.Land your own researchRecord your own research against companies or segments.

Reference

API referenceOne page per operation, generated from the contract the server validates against, with a try-it playground.OpenAPI documentThe machine-readable contract every reference page is projected from.llms.txtThe agent-readable index of this documentation.

Getting started

Mint an API key, make your first three calls, and find the guide for whatever you are doing next.

On this page

QuickstartWhat do you want to do?GuidesRecipesReference