1. Discovery search
Highperformr API
  • Introduction
  • Contacts
    • Bulk fetch contacts by IDs
      POST
    • Get contacts by segment
      POST
    • Get contact by ID
      GET
    • Update contact
      PATCH
    • Delete contact
      DELETE
    • Upsert contact into a source
      POST
    • Bulk upsert contacts for source
      POST
    • Unique values of one field for a filtered contact set
      POST
    • Unified Data API - async contact enrichment
      POST
  • Schema
    • Get contact schema
      GET
    • Get discovery search contact schema
      GET
    • Get discovery search company schema
      GET
    • Get options for field
      GET
    • Get discovery search options for field
      GET
  • Discovery search
    • Find contacts v2
      POST
    • Find companies v2
      POST
  • Jobs
    • Get job status by id
      GET
  • Social publishing
    • Create draft post
      POST
    • List posts (drafts, scheduled, published)
      POST
    • Schedule or publish posts (bulk)
      POST
    • Schedule a LinkedIn comment on an external post
      POST
    • Configure cross-account auto-repost
      POST
    • Upload media file (multipart)
      POST
    • Assemble chunked uploads into one file
      POST
    • Import media from a public URL
      POST
  • Integrations (social)
    • List social integrations (filter)
Login
  1. Discovery search

Find companies v2

POST
/discovery-search/find-companies-v2
Company discovery with the same pipeline as find-contacts-v2: groupedCondition and/or conditions, fields, limit, paginationToken.
Field paths must match GET /schema/discovery-search-v2/company (hpCompany.*; use hpContact.* when filtering on person attributes joined to the company).
Filter operators follow the same rules as the shared Condition schema (by field type).

Credits#

With a workspace or user API key, 1 credit per company returned in data. Use limit to cap usage.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Matching companies and pagination meta.
Bodyapplication/json

🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://app.highperformr.ai/api/discovery-search/find-companies-v2' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "groupedCondition": {
        "operator": "AND",
        "conditions": [
            {
                "field": "hpCompany.industry",
                "operator": "IN",
                "value": [
                    "Computer Software",
                    "Internet"
                ]
            },
            {
                "field": "hpCompany.company_name",
                "operator": "LIKE",
                "value": "Acme"
            }
        ]
    },
    "fields": [
        "hpCompany.company_name",
        "hpCompany.industry",
        "hpCompany.size_range"
    ],
    "limit": 42
}'
Response Response Example
200 - Success
{
    "data": [
        {
            "id": "cmp_4n8k2j1w",
            "companyName": "Acme Analytics Inc",
            "companyWebsite": "https://www.acme.io",
            "companyLinkedin": "https://www.linkedin.com/company/acme-analytics",
            "companyIndustry": "Computer Software",
            "companyHeadcount": "201-500",
            "companyCity": "Austin",
            "companyState": "TX",
            "companyCountry": "United States"
        }
    ],
    "meta": {
        "totalRecords": 12840,
        "previousToken": "eyJvIjoxfQ",
        "nextToken": "eyJvIjoyfQ"
    }
}
Modified at 2026-04-22 07:54:17
Previous
Find contacts v2
Next
Get job status by id
Built with