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": {
"company_list_id": "018f23b7-92bb-7c64-a3d4-1ba53b8ad971",
"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"
],
"includeMode": "CONTAINS",
"excludeMode": "CONTAINS"
},
"name": [
"John Doe"
],
"company_name": {
"include": [
"Google"
],
"exclude": [
"Amazon"
]
},
"look_alike": "google.com",
"lookAlike": "google.com",
"lookAlikeMode": "targeted",
"technologies": [
"Salesforce"
],
"fundingType": [
"seed"
],
"locationMode": "contact",
"keyword_filter": {
"exclude": "sales",
"include": "marketing",
"include_mode": "ANY"
},
"industry": {
"exclude": [
"Agriculture & Mining"
],
"include": [
"Agriculture & Mining"
]
},
"subIndustry": {
"exclude": [
"Animation"
],
"include": [
"Animation"
]
},
"domains": [
"google.com"
],
"website_visitors": true,
"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": {
"company_list_id": "018f23b7-92bb-7c64-a3d4-1ba53b8ad971",
"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"],
"includeMode": "CONTAINS",
"excludeMode": "CONTAINS"
},
"name": ["John Doe"],
"company_name": {
"include": ["Google"],
"exclude": ["Amazon"]
},
"look_alike": "google.com",
"lookAlike": "google.com",
"lookAlikeMode": "targeted",
"technologies": ["Salesforce"],
"fundingType": ["seed"],
"locationMode": "contact",
"keyword_filter": {
"exclude": "sales",
"include": "marketing",
"include_mode": "ANY"
},
"industry": {
"exclude": ["Agriculture & Mining"],
"include": ["Agriculture & Mining"]
},
"subIndustry": {
"exclude": ["Animation"],
"include": ["Animation"]
},
"domains": ["google.com"],
"website_visitors": True,
"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: {
company_list_id: '018f23b7-92bb-7c64-a3d4-1ba53b8ad971',
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'],
includeMode: 'CONTAINS',
excludeMode: 'CONTAINS'
},
name: ['John Doe'],
company_name: {include: ['Google'], exclude: ['Amazon']},
look_alike: 'google.com',
lookAlike: 'google.com',
lookAlikeMode: 'targeted',
technologies: ['Salesforce'],
fundingType: ['seed'],
locationMode: 'contact',
keyword_filter: {exclude: 'sales', include: 'marketing', include_mode: 'ANY'},
industry: {exclude: ['Agriculture & Mining'], include: ['Agriculture & Mining']},
subIndustry: {exclude: ['Animation'], include: ['Animation']},
domains: ['google.com'],
website_visitors: true,
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 \"company_list_id\": \"018f23b7-92bb-7c64-a3d4-1ba53b8ad971\",\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 \"includeMode\": \"CONTAINS\",\n \"excludeMode\": \"CONTAINS\"\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 \"lookAlike\": \"google.com\",\n \"lookAlikeMode\": \"targeted\",\n \"technologies\": [\n \"Salesforce\"\n ],\n \"fundingType\": [\n \"seed\"\n ],\n \"locationMode\": \"contact\",\n \"keyword_filter\": {\n \"exclude\": \"sales\",\n \"include\": \"marketing\",\n \"include_mode\": \"ANY\"\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 \"website_visitors\": true,\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' => [
'company_list_id' => '018f23b7-92bb-7c64-a3d4-1ba53b8ad971',
'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'
],
'includeMode' => 'CONTAINS',
'excludeMode' => 'CONTAINS'
],
'name' => [
'John Doe'
],
'company_name' => [
'include' => [
'Google'
],
'exclude' => [
'Amazon'
]
],
'look_alike' => 'google.com',
'lookAlike' => 'google.com',
'lookAlikeMode' => 'targeted',
'technologies' => [
'Salesforce'
],
'fundingType' => [
'seed'
],
'locationMode' => 'contact',
'keyword_filter' => [
'exclude' => 'sales',
'include' => 'marketing',
'include_mode' => 'ANY'
],
'industry' => [
'exclude' => [
'Agriculture & Mining'
],
'include' => [
'Agriculture & Mining'
]
],
'subIndustry' => [
'exclude' => [
'Animation'
],
'include' => [
'Animation'
]
],
'domains' => [
'google.com'
],
'website_visitors' => true,
'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 \"company_list_id\": \"018f23b7-92bb-7c64-a3d4-1ba53b8ad971\",\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 \"includeMode\": \"CONTAINS\",\n \"excludeMode\": \"CONTAINS\"\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 \"lookAlike\": \"google.com\",\n \"lookAlikeMode\": \"targeted\",\n \"technologies\": [\n \"Salesforce\"\n ],\n \"fundingType\": [\n \"seed\"\n ],\n \"locationMode\": \"contact\",\n \"keyword_filter\": {\n \"exclude\": \"sales\",\n \"include\": \"marketing\",\n \"include_mode\": \"ANY\"\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 \"website_visitors\": true,\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": "Insufficient credits",
"message": "Insufficient credits",
"errorCode": "CREDIT_RESERVATION_CONFLICT",
"creditsRequired": 50,
"creditsAvailable": 10,
"creditsReserved": 4000
}{
"statusCode": 403,
"error": "Lead limit reached",
"message": "Lead limit reached. Remaining uploads: 0",
"leadsRemaining": 0,
"leadsRequested": 100
}{
"statusCode": 404,
"error": "COMPANY_LIST_NOT_FOUND",
"message": "Company list not found",
"errorCode": "COMPANY_LIST_NOT_FOUND"
}{
"statusCode": 409,
"error": "COMPANY_LIST_NOT_READY",
"message": "Company list is not ready",
"errorCode": "COMPANY_LIST_NOT_READY",
"activeJobId": "01234567-89ab-cdef-0123-456789abcdef",
"activeJobStatus": 1
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Rate limit exceeded"
}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.
POST
/
api
/
v2
/
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": {
"company_list_id": "018f23b7-92bb-7c64-a3d4-1ba53b8ad971",
"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"
],
"includeMode": "CONTAINS",
"excludeMode": "CONTAINS"
},
"name": [
"John Doe"
],
"company_name": {
"include": [
"Google"
],
"exclude": [
"Amazon"
]
},
"look_alike": "google.com",
"lookAlike": "google.com",
"lookAlikeMode": "targeted",
"technologies": [
"Salesforce"
],
"fundingType": [
"seed"
],
"locationMode": "contact",
"keyword_filter": {
"exclude": "sales",
"include": "marketing",
"include_mode": "ANY"
},
"industry": {
"exclude": [
"Agriculture & Mining"
],
"include": [
"Agriculture & Mining"
]
},
"subIndustry": {
"exclude": [
"Animation"
],
"include": [
"Animation"
]
},
"domains": [
"google.com"
],
"website_visitors": true,
"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": {
"company_list_id": "018f23b7-92bb-7c64-a3d4-1ba53b8ad971",
"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"],
"includeMode": "CONTAINS",
"excludeMode": "CONTAINS"
},
"name": ["John Doe"],
"company_name": {
"include": ["Google"],
"exclude": ["Amazon"]
},
"look_alike": "google.com",
"lookAlike": "google.com",
"lookAlikeMode": "targeted",
"technologies": ["Salesforce"],
"fundingType": ["seed"],
"locationMode": "contact",
"keyword_filter": {
"exclude": "sales",
"include": "marketing",
"include_mode": "ANY"
},
"industry": {
"exclude": ["Agriculture & Mining"],
"include": ["Agriculture & Mining"]
},
"subIndustry": {
"exclude": ["Animation"],
"include": ["Animation"]
},
"domains": ["google.com"],
"website_visitors": True,
"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: {
company_list_id: '018f23b7-92bb-7c64-a3d4-1ba53b8ad971',
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'],
includeMode: 'CONTAINS',
excludeMode: 'CONTAINS'
},
name: ['John Doe'],
company_name: {include: ['Google'], exclude: ['Amazon']},
look_alike: 'google.com',
lookAlike: 'google.com',
lookAlikeMode: 'targeted',
technologies: ['Salesforce'],
fundingType: ['seed'],
locationMode: 'contact',
keyword_filter: {exclude: 'sales', include: 'marketing', include_mode: 'ANY'},
industry: {exclude: ['Agriculture & Mining'], include: ['Agriculture & Mining']},
subIndustry: {exclude: ['Animation'], include: ['Animation']},
domains: ['google.com'],
website_visitors: true,
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 \"company_list_id\": \"018f23b7-92bb-7c64-a3d4-1ba53b8ad971\",\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 \"includeMode\": \"CONTAINS\",\n \"excludeMode\": \"CONTAINS\"\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 \"lookAlike\": \"google.com\",\n \"lookAlikeMode\": \"targeted\",\n \"technologies\": [\n \"Salesforce\"\n ],\n \"fundingType\": [\n \"seed\"\n ],\n \"locationMode\": \"contact\",\n \"keyword_filter\": {\n \"exclude\": \"sales\",\n \"include\": \"marketing\",\n \"include_mode\": \"ANY\"\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 \"website_visitors\": true,\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' => [
'company_list_id' => '018f23b7-92bb-7c64-a3d4-1ba53b8ad971',
'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'
],
'includeMode' => 'CONTAINS',
'excludeMode' => 'CONTAINS'
],
'name' => [
'John Doe'
],
'company_name' => [
'include' => [
'Google'
],
'exclude' => [
'Amazon'
]
],
'look_alike' => 'google.com',
'lookAlike' => 'google.com',
'lookAlikeMode' => 'targeted',
'technologies' => [
'Salesforce'
],
'fundingType' => [
'seed'
],
'locationMode' => 'contact',
'keyword_filter' => [
'exclude' => 'sales',
'include' => 'marketing',
'include_mode' => 'ANY'
],
'industry' => [
'exclude' => [
'Agriculture & Mining'
],
'include' => [
'Agriculture & Mining'
]
],
'subIndustry' => [
'exclude' => [
'Animation'
],
'include' => [
'Animation'
]
],
'domains' => [
'google.com'
],
'website_visitors' => true,
'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 \"company_list_id\": \"018f23b7-92bb-7c64-a3d4-1ba53b8ad971\",\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 \"includeMode\": \"CONTAINS\",\n \"excludeMode\": \"CONTAINS\"\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 \"lookAlike\": \"google.com\",\n \"lookAlikeMode\": \"targeted\",\n \"technologies\": [\n \"Salesforce\"\n ],\n \"fundingType\": [\n \"seed\"\n ],\n \"locationMode\": \"contact\",\n \"keyword_filter\": {\n \"exclude\": \"sales\",\n \"include\": \"marketing\",\n \"include_mode\": \"ANY\"\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 \"website_visitors\": true,\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": "Insufficient credits",
"message": "Insufficient credits",
"errorCode": "CREDIT_RESERVATION_CONFLICT",
"creditsRequired": 50,
"creditsAvailable": 10,
"creditsReserved": 4000
}{
"statusCode": 403,
"error": "Lead limit reached",
"message": "Lead limit reached. Remaining uploads: 0",
"leadsRemaining": 0,
"leadsRequested": 100
}{
"statusCode": 404,
"error": "COMPANY_LIST_NOT_FOUND",
"message": "Company list not found",
"errorCode": "COMPANY_LIST_NOT_FOUND"
}{
"statusCode": 409,
"error": "COMPANY_LIST_NOT_READY",
"message": "Company list is not ready",
"errorCode": "COMPANY_LIST_NOT_READY",
"activeJobId": "01234567-89ab-cdef-0123-456789abcdef",
"activeJobStatus": 1
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Rate limit exceeded"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Search filters to find leads.
Show child attributes
Show child attributes
Maximum number of leads to import
Required range:
1 <= x <= 1000000Example:
100
Name of the search
Example:
"Tech CEOs in San Francisco"
Enable work email enrichment
Example:
true
Enable LinkedIn profile enrichment
Example:
true
Ordered list of providers for waterfall enrichment (enabled platforms only). When sent, it must be a non-empty list of distinct provider ids, spelled exactly as one of: instantly, findymail, leadmagic, icypeas, prospeo, contactout, wiza, bettercontact. An empty list, a repeated id or any other value is refused with a 400 that names each invalid entry.
Example:
[
"instantly",
"findymail",
"leadmagic",
"icypeas",
"prospeo",
"wiza",
"contactout"
]
Signal categories to enrich. Accepts the legacy plain-string form and the richer per-signal form with a freshness window and optional keyword filter. Matching signal records are fetched for the lead and written into the lead payload under the signal_category key.
Signal category name. Uses the default 30-day freshness window and no keyword filter.
Available options:
linkedin_post_company, linkedin_post_contact, linkedin_comment, twitter_post_company, twitter_post_contact, youtube_company, youtube_contact, reddit_buying_intent, reddit_pain_point, reddit_churn_risk, reddit_competitor_mention, glassdoor_negative, glassdoor_positive, website_product_launch, website_pricing_change, website_expansion, website_executive_change, website_funding, website_partnership, website_compliance, website_technology_adoption, job_change, promotion, work_anniversary, traffic_surge, traffic_decline Example:
"job_change"
ID of the list to target. A list is automatically created if not provided.
Example:
"01234567-89ab-cdef-0123-456789abcdef"
Whether to auto-update new leads
Example:
true
Whether to skip leads without email
Example:
true
Name for new list if resource_id not provided
Example:
"My List"
AI enrichment configuration. Keys are output column names, values are enrichment details.
Response
Default Response
Unique identifier for the enrichment
Example:
"01234567-89ab-cdef-0123-456789abcdef"
Organization ID that created this enrichment
Example:
"01234567-89ab-cdef-0123-456789abcdef"
ID of the list
Example:
"01234567-89ab-cdef-0123-456789abcdef"
Resource type: 1=Campaign, 2=List (default)
Available options:
1, 2 Example:
2
The search filters used for enrichment
Maximum number of leads to import
Example:
100
Name of the list created
Example:
"Supersearch List (22 Sep 2025)"
Custom flow to apply to the enrichment
Identifier of an associated background import job, when one is spawned. null when no background job was created for this request.
Example:
"6a12f7882bf0c40356be515c"
Deprecated: always null. Live lists are retired — use a Lead Finder Agent instead.
Example:
"01234567-89ab-cdef-0123-456789abcdef"