--- title: "Enrich leads from supersearch" method: POST path: "/api/v2/supersearch-enrichment/enrich-leads-from-supersearch" tags: ["SuperSearchEnrichment"] --- # Enrich leads from supersearch `POST /api/v2/supersearch-enrichment/enrich-leads-from-supersearch` Add leads from SuperSearch to a list and enrich them. A list is automatically created if no list is provided. ## Request body - object - `search_filters` object, required — Search filters to find leads. - `locations` union - union[] — Legacy format: Array of locations to include in the search. For new integrations, use the object format with include/exclude properties. - union - object - `place_id` string, required — Google Maps Place ID of the lead's location (https://developers.google.com/maps/documentation/places/web-service/place-id) - `label` string — Label of the lead's location - union - unknown - unknown - unknown - object — Locations to include or exclude in the search - `include` union[] — Locations to include in the search - union - object - … - union - … - `exclude` union[] — Locations to exclude from the search - union - object - … - union - … - `department` string[] - `level` string[] - `employeeCount` union[] — Employee count filters. - union - '0 - 25' | '25 - 100' | '100 - 250' | '250 - 1000' | '1K - 10K' | '10K - 50K' | '50K - 100K' | '> 100K' — Legacy format: Predefined employee count range - object — Custom employee count range - `op` string, required — Operation type. - `min` number — Minimum employee count (inclusive), used for "between" and "gte" operations - `max` number — Maximum employee count (inclusive), used for "between" and "lte" operations - `revenue` string[] - `news` string[] - `jobListing` string[] — Canonical filter for companies that are hiring for the specified job titles. - `jobListingFilter` string[] — Deprecated compatibility key for Job Listing filters. Use `jobListing` instead. If both keys are present, `jobListing` takes precedence. - `title` object - `include` string[] — Titles of the lead to include in the search - `exclude` string[] — Titles of the lead to exclude in the search - `name` string[] — Names of the lead to include in the search - `company_name` object - `include` string[] — Companies of the lead to include in the search - `exclude` string[] — Companies of the lead to exclude in the search - `look_alike` string — If set, the lead finder will find companies that are similar to the look-alike domain - `keyword_filter` object - `exclude` string - `include` string - `industry` object - `exclude` string[] — Industries of the lead company to exclude in the search - `include` string[] - `subIndustry` object - `exclude` string[] — Subindustries of the lead company to exclude in the search - `include` string[] — Subindustries of the lead company to include in the search - `domains` string[] - `funding_type` string[] - `signals` union[] — Filter leads by Autobound signal categories (e.g. job changes, traffic surges, LinkedIn activity). Leads matching ANY of the specified signals within the per-signal freshness window will be returned. - union - string — Signal category name. Uses the default 30-day freshness window. - object - `key` string, required — Signal category to filter by. - `period_days` number — Freshness window in days. Only leads whose most recent signal of this category is within this window are returned. Defaults to 30 if omitted. - `keywords` union - string[] — Legacy flat list of keyword tokens (OR-matched across every keyword index field for the category). - object — Per-field map of keyword tokens. Each property name is a keyword index field; each value is the list of tokens to OR-match within that field. Records must have at least one matching token in EACH selected field — fields act as additional filters. Example: `{ "objection_type": ["security"], "buying_stage": ["consideration"] }`. - `skip_owned_leads` boolean — If set, the lead finder will skip leads that are owned by the user - `show_one_lead_per_company` boolean — If set, the lead finder will show only one lead per company - `location_mode` 'contact' | 'company' — Whether to filter/display by contact location or company HQ location. Defaults to contact. - `search_name` string — Name of the search - `work_email_enrichment` boolean — Enable work email enrichment - `fully_enriched_profile` boolean — Enable LinkedIn profile enrichment - `custom_flow` string[] — Ordered list of providers for waterfall enrichment (enabled platforms only) - `signal_enrichment` union[] — 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. - union - string — Signal category name. Uses the default 30-day freshness window and no keyword filter. - object - `key` string, required — Signal category to enrich. - `period_days` number — Freshness window in days. Only signals whose most recent record is within this window are attached to the lead payload. Defaults to 30 if omitted. - `keywords` union - string[] — Legacy flat list (OR-matched across every keyword index field for the category). - object — Per-field map: each property is a keyword index field; tokens within a field are OR-matched, and fields act as additional filters (records must hit at least one token per selected field). Example: `{ "objection_type": ["security"], "buying_stage": ["consideration"] }`. - `resource_id` string, uuid — ID of the list to target. A list is automatically created if not provided. - `auto_update` boolean — Whether to auto-update new leads - `skip_rows_without_email` boolean — Whether to skip leads without email - `list_name` string — Name for new list if resource_id not provided - `limit` number, required — Maximum number of leads to import - `ai_enrichment` object — AI enrichment configuration. Keys are output column names, values are enrichment details. ## Response `200` Default Response - object - `id` string, required — Unique identifier for the enrichment - `organization_id` string, uuid, required — Organization ID that created this enrichment - `resource_id` string, uuid, required — ID of the list - `resource_type` 1 | 2 — Resource type: 1=Campaign, 2=List (default) - `search_filters` object — The search filters used for enrichment - `limit` number — Maximum number of leads to import - `list_name` string — Name of the list created - `custom_flow` string[] — Custom flow to apply to the enrichment - `background_job_id` string, 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_id` string, nullable — Deprecated: always `null`. Live lists are retired — use a Lead Finder Agent instead. ## Other responses - `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked) - `402` — This request cannot be fulfilled because the workspace does not have an active paid plan - `404` — The requested resource was not found - `429` — You have exceeded the rate limit. Please check the rate limit docs for more information. --- [API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/revisions/378d1e253fe7/schema)