Developers/Docs/Contacts API

Contacts API

Search over 5.5 million government-verified business contacts. Preview results are free — use reveal to unlock full contact details.

Search Contacts

GET/api/v1/contacts/search

Query Parameters

Parameter	Type	Description
q	string	Search query (business name, category, keyword)
state	string	Two-letter state code (e.g. CA, TX, NY)
city	string	City name filter
industry	string	Industry vertical (e.g. healthcare, legal, home-services)
limit	integer	Results per page (default 25, max 100)
offset	integer	Pagination offset

bash

curl "https://api.siedata.dev/api/v1/contacts/search?q=dentist&state=TX&limit=10" \
  -H "X-API-Key: vpx_live_YOUR_KEY"

json

{
  "contacts": [
    {
      "id": "ct_abc123",
      "business_name": "Bright Smile Dental",
      "city": "Austin",
      "state": "TX",
      "industry": "healthcare",
      "preview": true
    }
  ],
  "total": 1842,
  "limit": 10,
  "offset": 0
}

Reveal Contact

POST/api/v1/contacts/reveal

Unlock full details for a contact. Each reveal deducts one credit from your account.

bash

curl -X POST "https://api.siedata.dev/api/v1/contacts/reveal" \
  -H "X-API-Key: vpx_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": "ct_abc123"}'

Batch Operations

POST/api/v1/contacts/batch-reveal

Reveal up to 100 contacts in a single request. Returns results as they complete.

json

{
  "contact_ids": ["ct_abc123", "ct_def456", "ct_ghi789"],
  "webhook_url": "https://your-app.com/webhook/contacts"
}

Contribute Contacts

POST/api/v1/contacts/contribute

Publishers can contribute contacts to earn revenue share credits. Contributed contacts are validated and deduplicated before inclusion.

json

{
  "contacts": [
    {
      "business_name": "Example Corp",
      "phone": "+15551234567",
      "city": "Miami",
      "state": "FL",
      "industry": "home-services"
    }
  ]
}