Enrich leads from supersearch

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"
    ],
    "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"
  },
  "limit": 100
}
'

import requests

url = "https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch"

payload = {
    "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"
    },
    "limit": 100
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
    },
    limit: 100
  })
};

fetch('https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
    ],
    'limit' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch"

	payload := strings.NewReader("{\n  \"search_filters\": {\n    \"locations\": [\n      {\n        \"place_id\": \"ChIJN1t_t3uEmsRUso9K6W47H4\",\n        \"label\": \"San Francisco, CA, USA\"\n      }\n    ],\n    \"department\": [\n      \"Engineering\"\n    ],\n    \"level\": [\n      \"Entry level\"\n    ],\n    \"employeeCount\": [\n      \"0 - 25\"\n    ],\n    \"revenue\": [\n      \"$1 - 10M\"\n    ],\n    \"news\": [\n      \"launches\"\n    ],\n    \"jobListing\": [\n      \"Software Engineer\"\n    ],\n    \"jobListingFilter\": [\n      \"Software Engineer\"\n    ],\n    \"title\": {\n      \"include\": [\n        \"CEO\"\n      ],\n      \"exclude\": [\n        \"VP\"\n      ]\n    },\n    \"name\": [\n      \"John Doe\"\n    ],\n    \"company_name\": {\n      \"include\": [\n        \"Google\"\n      ],\n      \"exclude\": [\n        \"Amazon\"\n      ]\n    },\n    \"look_alike\": \"google.com\",\n    \"keyword_filter\": {\n      \"exclude\": \"sales\",\n      \"include\": \"marketing\"\n    },\n    \"industry\": {\n      \"exclude\": [\n        \"Agriculture & Mining\"\n      ],\n      \"include\": [\n        \"Agriculture & Mining\"\n      ]\n    },\n    \"subIndustry\": {\n      \"exclude\": [\n        \"Animation\"\n      ],\n      \"include\": [\n        \"Animation\"\n      ]\n    },\n    \"domains\": [\n      \"google.com\"\n    ],\n    \"funding_type\": [\n      \"angel\"\n    ],\n    \"signals\": [\n      \"job_change\"\n    ],\n    \"skip_owned_leads\": true,\n    \"show_one_lead_per_company\": true,\n    \"location_mode\": \"contact\"\n  },\n  \"limit\": 100\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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"
  ],
  "background_job_id": "6a12f7882bf0c40356be515c",
  "live_list_workflow_id": "01234567-89ab-cdef-0123-456789abcdef"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing Authorization header"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Workspace does not have an active paid plan"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}

POST

api

supersearch-enrichment

enrich-leads-from-supersearch

Enrich leads from supersearch

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"
    ],
    "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"
  },
  "limit": 100
}
'

import requests

url = "https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch"

payload = {
    "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"
    },
    "limit": 100
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
    },
    limit: 100
  })
};

fetch('https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
    ],
    'limit' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.instantly.ai/api/v2/supersearch-enrichment/enrich-leads-from-supersearch"

	payload := strings.NewReader("{\n  \"search_filters\": {\n    \"locations\": [\n      {\n        \"place_id\": \"ChIJN1t_t3uEmsRUso9K6W47H4\",\n        \"label\": \"San Francisco, CA, USA\"\n      }\n    ],\n    \"department\": [\n      \"Engineering\"\n    ],\n    \"level\": [\n      \"Entry level\"\n    ],\n    \"employeeCount\": [\n      \"0 - 25\"\n    ],\n    \"revenue\": [\n      \"$1 - 10M\"\n    ],\n    \"news\": [\n      \"launches\"\n    ],\n    \"jobListing\": [\n      \"Software Engineer\"\n    ],\n    \"jobListingFilter\": [\n      \"Software Engineer\"\n    ],\n    \"title\": {\n      \"include\": [\n        \"CEO\"\n      ],\n      \"exclude\": [\n        \"VP\"\n      ]\n    },\n    \"name\": [\n      \"John Doe\"\n    ],\n    \"company_name\": {\n      \"include\": [\n        \"Google\"\n      ],\n      \"exclude\": [\n        \"Amazon\"\n      ]\n    },\n    \"look_alike\": \"google.com\",\n    \"keyword_filter\": {\n      \"exclude\": \"sales\",\n      \"include\": \"marketing\"\n    },\n    \"industry\": {\n      \"exclude\": [\n        \"Agriculture & Mining\"\n      ],\n      \"include\": [\n        \"Agriculture & Mining\"\n      ]\n    },\n    \"subIndustry\": {\n      \"exclude\": [\n        \"Animation\"\n      ],\n      \"include\": [\n        \"Animation\"\n      ]\n    },\n    \"domains\": [\n      \"google.com\"\n    ],\n    \"funding_type\": [\n      \"angel\"\n    ],\n    \"signals\": [\n      \"job_change\"\n    ],\n    \"skip_owned_leads\": true,\n    \"show_one_lead_per_company\": true,\n    \"location_mode\": \"contact\"\n  },\n  \"limit\": 100\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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"
  ],
  "background_job_id": "6a12f7882bf0c40356be515c",
  "live_list_workflow_id": "01234567-89ab-cdef-0123-456789abcdef"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing Authorization header"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Workspace does not have an active paid plan"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}

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

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

Default Response

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

background_job_id

null | string

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

Example:

"6a12f7882bf0c40356be515c"

live_list_workflow_id

null | string

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

Example:

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

Update enrichment settings for resource Run enrichment for resource

⌘I

Overview

Getting Started

Guides

Resources

Schemas

Enrich leads from supersearch

Authorizations

Body

Response