Search Companies

Search the PrimoDato company index using firmographic and technographic filters. Results are paginated and company identity stays masked until revealed.

Request

Endpoint: GET /v1/companies. Required headers: Authorization: Bearer {api_key} and Content-Type: application/json.

Parameter	Type	Description	Example
q	string	Full-text search across company name, domain, and description	salesforce consulting
industry	string[]	Industry slug. Repeatable.	hospitality
country	string[]	ISO 3166-1 alpha-2 country codes	US
city	string	City name partial match	New York
state	string	State or region	California
employees	string[]	Employee range filter	51-200
revenue	string[]	Revenue range filter	$10M-$50M
company_type	string[]	public, private, startup, non-profit, government	private
founded_after	integer	Founded after this year	2015
founded_before	integer	Founded before this year	2020
verified_only	boolean	Return verified records only	true
tech	string[]	Technology slug(s). Company must use all listed tech	salesforce
tech_any	string[]	Company must use at least one listed technology	shopify
tech_not	string[]	Exclude companies using these technologies	hubspot
tech_category	string[]	Filter by technology category	crm
sort	string	relevance, name, employees, revenue, founded, last_enriched	relevance
order	string	asc or desc	desc
page	integer	1-based page number	1
limit	integer	Results per page. Max 100.	25

Response

{
  "data": [
    {
      "id": "cmp_01hxyz123abc",
      "name": null,
      "domain": null,
      "_masked": true,
      "industry": "Hospitality & Travel",
      "industry_slug": "hospitality",
      "employee_range": "51-200",
      "revenue_range": "$10M-$50M",
      "country": "US",
      "country_name": "United States",
      "city": "Austin",
      "state": "TX",
      "company_type": "private",
      "founded_year": 2012,
      "description": "Property management and booking software for boutique hotels.",
      "is_verified": true,
      "last_enriched_at": "2025-01-12T00:00:00Z",
      "technologies": [
        {
          "name": "Cloudbeds",
          "slug": "cloudbeds",
          "category": "Property Management",
          "confidence": 95
        },
        {
          "name": "Stripe",
          "slug": "stripe",
          "category": "Payment Processing",
          "confidence": 88
        }
      ],
      "_contact_count": 4,
      "data_quality_score": 87
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 8420,
    "pages": 337,
    "has_next": true,
    "has_prev": false
  },
  "meta": {
    "query_time_ms": 124,
    "credits_used": 0
  }
}

name and domain return null for unrevealed companies. Use POST /v1/companies/{id}/reveal to unlock full data.

Code Examples

curl "https://api.primodato.com/v1/companies?industry=hospitality&country=US&employees=51-200&tech=cloudbeds&limit=25" \
  -H "Authorization: Bearer db_live_xxxxxxxxxxxxxxxxxxxx"