Explorium

Troubleshooting

If requests fail, run zero doctor check-connector --env-name EXPLORIUM_TOKEN or zero doctor check-connector --url https://api.explorium.ai/v1/businesses/stats --method POST

How to Use

All examples below assume you have EXPLORIUM_TOKEN set.

The base URL for the Explorium API is:

• https://api.explorium.ai

The API key is passed via the api_key header in all requests.

1. Get Business Statistics

Check the total number of businesses matching your filters before fetching records:

Write to /tmp/explorium_request.json:

{
  "filters": {
    "country": {
      "values": ["United States"]
    },
    "industry": {
      "values": ["Software"]
    }
  }
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/businesses/stats" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

2. Match a Business

Find a business by name or domain and get its unique business_id:

Write to /tmp/explorium_request.json:

{
  "name": "Explorium",
  "website": "explorium.ai"
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/businesses/match" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

3. Fetch Businesses

Retrieve business records matching specific filters:

Write to /tmp/explorium_request.json:

{
  "mode": "full",
  "page": 1,
  "page_size": 10,
  "filters": {
    "country": {
      "values": ["United States"]
    },
    "number_of_employees": {
      "values": [{"min": 50, "max": 500}]
    }
  }
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/businesses" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

4. Enrich a Business

Enrich a business with specific data categories. Replace <enrichment_name> with the enrichment type (e.g., firmographics, technographics, financial_metrics):

Write to /tmp/explorium_request.json:

{
  "business_id": "<your-business-id>"
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/businesses/<enrichment_name>/enrich" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

Common enrichment types:

• firmographics - Company size, industry, location, revenue
• technographics - Technology stack and tools used
• financial_metrics - Revenue, funding, financial indicators
• social_media - Social media presence and metrics

5. Bulk Enrich Businesses

Enrich multiple businesses at once (up to 50 per request):

Write to /tmp/explorium_request.json:

{
  "business_ids": [
    "8adce3ca1cef0c986b22310e369a0793",
    "a34bacf839b923770b2c360eefa26748"
  ]
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/businesses/<enrichment_name>/bulk_enrich" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

6. Fetch Prospects

Search for prospects (people) matching specific criteria:

Write to /tmp/explorium_request.json:

{
  "mode": "full",
  "page": 1,
  "page_size": 10,
  "filters": {
    "job_level": {
      "values": ["C-Level"]
    },
    "department": {
      "values": ["Engineering"]
    },
    "business_id": {
      "values": ["<your-business-id>"]
    }
  }
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/prospects" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

7. Match a Prospect

Find a specific prospect by name and company:

Write to /tmp/explorium_request.json:

{
  "first_name": "John",
  "last_name": "Doe",
  "company_name": "Explorium"
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/prospects/match" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

8. Enrich Prospect Contact Information

Get contact details for a specific prospect:

Write to /tmp/explorium_request.json:

{
  "prospect_id": "<your-prospect-id>"
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/prospects/contacts_information/enrich" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

9. Get Prospect Statistics

Check the total number of prospects matching your filters:

Write to /tmp/explorium_request.json:

{
  "filters": {
    "job_level": {
      "values": ["C-Level", "VP"]
    },
    "business_id": {
      "values": ["<your-business-id>"]
    }
  }
}

Then run:

curl -s -X POST "https://api.explorium.ai/v1/prospects/stats" --header "Content-Type: application/json" --header "api_key: $EXPLORIUM_TOKEN" -d @/tmp/explorium_request.json | jq .

10. Autocomplete Businesses

Search for businesses by partial name for quick lookups:

curl -s -X GET "https://api.explorium.ai/v1/businesses/autocomplete?query=explor" --header "api_key: $EXPLORIUM_TOKEN" | jq .

Guidelines

1. Use the match endpoint first to obtain business_id or prospect_id before calling enrichment endpoints 2. Check stats before fetching to understand result set size and optimize pagination 3. Use bulk endpoints when enriching multiple records to reduce API calls and stay within rate limits 4. Paginate large result sets with page and page_size parameters (max 100 per page) 5. Store IDs for reuse since business and prospect IDs are stable identifiers 6. Monitor rate limits of 200 queries per minute to avoid throttling