Enrich leads from supersearch

Add leads from SuperSearch to a list and enrich them. A list is automatically created if no list is provided.

POST /api/v2/supersearch-enrichment/enrich-leads-from-supersearch

Enrich leads from supersearch

cURL

curl --request POST \
  --url https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "search_filters": {
    "locations": [
      {
        "place_id": "ChIJN1t_t3uEmsRUso9K6W47H4",
        "label": "San Francisco, CA, USA"
      }
    ],
    "department": [
      "Engineering"
    ],
    "level": [
      "Entry level"
    ],
    "employeeCount": [
      "0 - 25"
    ],
    "revenue": [
      "$1 - 10M"
    ],
    "news": [
      "launches"
    ],
    "title": {
      "include": [
        "CEO"
      ],
      "exclude": [
        "VP"
      ]
    },
    "name": [
      "John Doe"
    ],
    "company_name": {
      "include": [
        "Google"
      ],
      "exclude": [
        "Amazon"
      ]
    },
    "look_alike": "google.com",
    "keyword_filter": {
      "exclude": "sales",
      "include": "marketing"
    },
    "industry": {
      "exclude": [
        "Agriculture & Mining"
      ],
      "include": [
        "Agriculture & Mining"
      ]
    },
    "subIndustry": {
      "exclude": [
        "Animation"
      ],
      "include": [
        "Animation"
      ]
    },
    "domains": [
      "google.com"
    ],
    "funding_type": [
      "angel"
    ],
    "signals": [
      "job_change"
    ],
    "skip_owned_leads": true,
    "show_one_lead_per_company": true,
    "location_mode": "contact"
  },
  "limit": 100
}
'

200

{
  "id": "01234567-89ab-cdef-0123-456789abcdef",
  "organization_id": "01234567-89ab-cdef-0123-456789abcdef",
  "resource_id": "01234567-89ab-cdef-0123-456789abcdef",
  "resource_type": 2,
  "search_filters": {},
  "limit": 100,
  "list_name": "Supersearch List (22 Sep 2025)",
  "custom_flow": [
    "instantly"
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

search_filters · object · required

Search filters to find leads.

Show child attributes

limit · number · required

Maximum number of leads to import

Required range: 1 <= x <= 1000000

Example:

100

search_name · string

Name of the search

Example:

"Tech CEOs in San Francisco"

work_email_enrichment · boolean

Enable work email enrichment

Example:

true

fully_enriched_profile · boolean

Enable LinkedIn profile enrichment

Example:

true

custom_flow · string[]

Ordered list of providers for waterfall enrichment (enabled platforms only)

Example:

[
  "instantly",
  "findymail",
  "leadmagic",
  "icypeas",
  "prospeo",
  "wiza",
  "contactout"
]

signal_enrichment · (string | object)[]

Signal categories to enrich from Autobound data. Accepts the legacy plain-string form and the richer per-signal form with a freshness window and optional keyword filter. The worker fetches matching signal records for the lead and writes the raw data into the lead payload under the signal_category key.

Signal category name. Uses the default 30-day freshness window and no keyword filter.

Example:

"job_change"

resource_id · string<uuid>

ID of the list to target. A list is automatically created if not provided.

Example:

"01234567-89ab-cdef-0123-456789abcdef"

auto_update · boolean

Whether to auto-update new leads

Example:

true

evergreen · object

Show child attributes

skip_rows_without_email · boolean

Whether to skip leads without email

Example:

true

list_name · string

Name for new list if resource_id not provided

Example:

"My List"

ai_enrichment · object

AI enrichment configuration. Keys are output column names, values are enrichment details.

Response

200

application/json

Default Response

id · string · required

Unique identifier for the enrichment

Example:

"01234567-89ab-cdef-0123-456789abcdef"

organization_id · string<uuid> · required

Organization ID that created this enrichment

Example:

"01234567-89ab-cdef-0123-456789abcdef"

resource_id · string<uuid> · required

ID of the list

Example:

"01234567-89ab-cdef-0123-456789abcdef"

resource_type · enum<number>

Resource type: 1=Campaign, 2=List (default)

Available options: 1, 2

Example:

2

search_filters · object

The search filters used for enrichment

limit · number

Maximum number of leads to import

Example:

100

list_name · string

Name of the list created

Example:

"Supersearch List (22 Sep 2025)"

custom_flow · string[]

Custom flow to apply to the enrichment