Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.descovo.com/llms.txt

Use this file to discover all available pages before exploring further.

Descovo authenticates every request using an API key that you include in the request body. This guide walks you through getting your key, making a test search, and understanding the response format.

​
Step 1: Get your API key

Sign up at descovo.com/sign-up. After registration, your API key is available in your dashboard. It starts with sk_live_.
Keep your API key secure. Do not commit it to source control or share it publicly.

​
Step 2: Make your first API call

The simplest way to test your key is a company search. Send a POST request to /v1/company-search: 
curl -X POST https://api.descovo.com/v1/company-search \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "sk_live_xxx",
    "searchParams": {
      "keywords": ["artificial intelligence"],
      "headquartersCountryCode": ["US"]
    },
    "pageSize": 5,
    "cursor": null
  }'

​
Step 3: Understand the response

Every Descovo response follows the same envelope structure: 
{
  "output": {
    "data": [
      {
        "preferred_name": "Acme AI",
        "domains": ["acme.ai"],
        "linkedin_primary_slug": "acme-ai",
        "standard_industries": ["artificial-intelligence"],
        "employee_count_consensus": { "min": 50, "max": 200 },
        "location_consensus": { "city": "San Francisco", "country_code": "US" },
        "total_funding_consensus": { "usd": 15000000 }
      }
    ],
    "nextCursor": "opaque_cursor_string"
  },
  "chargeInfo": {
    "method": "charged-now",
    "creditsCharged": 5
  }
}
Key fields in every response:
  • output.data — the array of results
  • output.nextCursor — pass this back as cursor to get the next page; null means no more results
  • chargeInfo.creditsCharged — how many credits this request consumed

​
Step 4: Check your credit balance

Use GET /v1/credits to see your remaining credits before running large queries: 
curl "https://api.descovo.com/v1/credits?apiKey=sk_live_xxx"

​
Next steps

People Search

Find professionals by title, company, and location

Company Search

Discover companies with rich filter options

Contact Enrichment

Get emails and phone numbers for known profiles

Audience Workflow

Build and enrich large prospect lists at scale