Quickstart

Make your first Spotium API call in under a minute.

1. Get an API key

Sign in to the Spotium dashboard and open Settings → API Keys. Create a key and copy it — you won't be able to see it again.

2. Set your key as an environment variable

bashbash
export SPOTIUM_API_KEY="sk_live_..."

3. Make a request

Enrich a contact by name and company:

bashbash
curl https://api.spotium.app/v1/people/enrich \
  -H "Authorization: Bearer $SPOTIUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Satya Nadella",
    "company": "Microsoft"
  }'

4. Read the response

jsonjson
{
  "status": "matched",
  "person": {
    "full_name": "Satya Nadella",
    "title": "Chairman and CEO",
    "seniority": "cxo",
    "linkedin_url": "https://www.linkedin.com/in/satyanadella",
    "email": "s****@microsoft.com",
    "email_status": "verified",
    "phone": null
  },
  "company": {
    "name": "Microsoft",
    "domain": "microsoft.com",
    "website": "https://www.microsoft.com"
  },
  "sources": ["apollo", "internal"]
}

Next steps

  • Explore all four endpoints under Endpoints in the sidebar.
  • Try requests live from the panel on each endpoint page.
  • Read about rate limits and error codes.