Sign in

v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB
SuperSearchEnrichment

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

Request body

search_namestring

Name of the search

work_email_enrichmentboolean

Enable work email enrichment

fully_enriched_profileboolean

Enable LinkedIn profile enrichment

custom_flowstring[]

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

resource_idstring uuid

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

auto_updateboolean

Whether to auto-update new leads

skip_rows_without_emailboolean

Whether to skip leads without email

list_namestring

Name for new list if resource_id not provided

limitnumber required

Maximum number of leads to import

ai_enrichmentobject

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

Example request

{
  "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"
    ],
    "jobListing": [
      "Software Engineer"
    ],
    "jobListingFilter": [
      "Software Engineer"
    ],
    "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"
  },
  "search_name": "Tech CEOs in San Francisco",
  "work_email_enrichment": true,
  "fully_enriched_profile": true,
  "custom_flow": [
    "instantly",
    "findymail",
    "leadmagic",
    "icypeas",
    "prospeo",
    "wiza",
    "contactout"
  ],
  "signal_enrichment": [
    "job_change"
  ],
  "resource_id": "01234567-89ab-cdef-0123-456789abcdef",
  "auto_update": true,
  "skip_rows_without_email": true,
  "list_name": "My List",
  "limit": 100
}

Response

Default Response

idstring required

Unique identifier for the enrichment

organization_idstring uuid required

Organization ID that created this enrichment

resource_idstring uuid required

ID of the list

resource_type1 | 2

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

search_filtersobject

The search filters used for enrichment

limitnumber

Maximum number of leads to import

list_namestring

Name of the list created

custom_flowstring[]

Custom flow to apply to the enrichment

background_job_idstring nullable

Identifier of an associated background import job, when one is spawned. null when no background job was created for this request.

live_list_workflow_idstring nullable

Deprecated: always null. Live lists are retired — use a Lead Finder Agent instead.

Example response

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