Seamless.AI
App · 19 actions
Find B2B contacts and companies in Seamless.AI and research them for verified emails, phone numbers and company details, read what your organization has researched, and organize it in lists. Start a workflow when a contact or company is researched.
Actions
| Action | What it does |
|---|---|
| Create list | Create a list to collect researched contacts and companies in. |
| Delete list | Delete a list. |
| Get company research results | See where each company research stands, with the company's details once it's done. |
| Get contact research results | See where each contact research stands, with the person's details once it's done. |
| Get credit balances | Get the credits left in each of your credit categories and when they refresh. |
| Get current user | Get the Seamless.AI user the API key belongs to, and the credits your organization has left. |
| List lists | List your Seamless.AI lists. |
| List researched companies | List the companies your organization researched in a time window, with their details. |
| List researched contacts | List the people your organization researched in a time window, from the app, the Chrome extension or here, with their emails and phones. |
| Look up location | Find the exact spelling of a city, state, country or postal code to use in a search's locations, most common first. |
| Rename list | Give a list a new name. |
| Research companies | Start researching up to 500 companies from search results, websites or names, and get a request ID for each. |
| Research company | Get a company's details (phones, address, size, revenue, technologies and funding) from its website or name, and wait up to 90 seconds for the result. |
| Research contact | Get one person's verified emails, phone numbers and job details, from a search result, their email, their LinkedIn link, or their name and company, and wait up to 90 seconds for the result. |
| Research contacts | Start researching up to 500 people from search results, emails or LinkedIn links, and get a request ID for each. |
| Search companies | Find companies by name, website, place, industry, size, revenue, technology and funding. |
| Search contacts | Find people by job title, seniority, department, company, place, industry and more. |
| Update company lists | Add researched companies to lists, remove them from lists, or make some lists their only ones. |
| Update contact lists | Add researched contacts to lists, remove them from lists, or make some lists their only ones. |
Create list
Create a list to collect researched contacts and companies in. Needs Public API v2.
Inputs
- Name
nametextRequired - The list's name. Each of your lists needs a different name.
Outputs
listobject- The list
list_idtext- The list's ID
Example output
{
"list": {
"createdAt": "2026-11-18T09:00:00Z",
"listId": "123",
"name": "Lodol leads",
"updatedAt": "2026-11-18T09:00:00Z"
},
"list_id": "123"
}Delete list
Delete a list. The contacts and companies on it stay researched. Needs Public API v2.
Inputs
- List
list_idtextRequired - The list. Pick one, or give its ID from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
list_idtext- The list's ID
Example output
{
"deleted": true,
"list_id": "123"
}Get company research results
See where each company research stands, with the company's details once it's done. Free.
Inputs
- Request IDs
request_idslistRequired - The 'request_ids' a research step returned, up to 500.
Outputs
all_finishedtrue/false- Whether none is still being researched
countnumber- How many are in this answer
done_countnumber- How many have finished with details
pending_countnumber- How many are still being researched
resultslist- Each research request and where it stands
Example output
{
"all_finished": true,
"count": 1,
"done_count": 1,
"pending_count": 0,
"results": [
{
"company": {
"companyId": "9120044",
"companyName": "Acme Corp",
"companyRevenue": "$20M - $50M",
"companySize": "201 - 500",
"companyType": "Private",
"createdAt": "2026-11-18T09:00:00Z",
"description": "Acme makes software for logistics teams.",
"domain": "acme.com",
"foundedOn": "2012",
"fundingTotal": "25000000",
"latestFundingDate": "2025-03-01",
"linkedInProfileUrl": "https://www.linkedin.com/company/acme",
"location": {
"city": "Austin",
"country": "United States",
"postCode": "78701",
"state": "Texas",
"street1": "100 Congress Ave"
},
"phones": "+1 512 555 0100",
"researchedAt": "2026-11-18T09:00:00Z",
"staffCount": "320",
"stockTicker": "",
"topTechnologies": "Salesforce, HubSpot",
"updatedAt": "2026-11-18T09:00:00Z"
},
"message": "",
"request_id": "zfojB7c6brQ0fIGrCvwHT",
"status": "done"
}
]
}Get contact research results
See where each contact research stands, with the person's details once it's done. Free.
Inputs
- Request IDs
request_idslistRequired - The 'request_ids' a research step returned, up to 500.
Outputs
all_finishedtrue/false- Whether none is still being researched
countnumber- How many are in this answer
done_countnumber- How many have finished with details
pending_countnumber- How many are still being researched
resultslist- Each research request and where it stands
Example output
{
"all_finished": true,
"count": 1,
"done_count": 1,
"pending_count": 0,
"results": [
{
"contact": {
"city": "Austin",
"companyDomain": "acme.com",
"companyName": "Acme Corp",
"companyPhone1": "+1 512 555 0100",
"companyRevenue": "$20M - $50M",
"companySize": "201 - 500",
"contactId": "48213377",
"contactPhone1": "+1 512 555 0199",
"contactPhone1DataType": "mobile",
"country": "United States",
"createdAt": "2026-11-18T09:00:00Z",
"department": "Sales",
"email": "jane.doe@acme.com",
"email1EmailAI": "valid",
"firstName": "Jane",
"fullName": "Jane Doe",
"jobChangeAlert": "",
"jobTitle": "VP of Sales",
"lIProfileUrl": "https://www.linkedin.com/in/janedoe",
"lastName": "Doe",
"personalEmail": "",
"researchedAt": "2026-11-18T09:00:00Z",
"researchedTypes": [
"email",
"phone"
],
"seniority": "VP",
"state": "Texas",
"tags": [
"Lodol leads"
],
"updatedAt": "2026-11-18T09:00:00Z"
},
"message": "",
"request_id": "zfojB7c6brQ0fIGrCvwHT",
"status": "done"
}
]
}Get credit balances
Get the credits left in each of your credit categories and when they refresh. Free. Needs Public API v2.
Inputs
None.
Outputs
balanceslist- Credits left in each credit category
countnumber- How many are in this answer
Example output
{
"balances": [
{
"category": "Contact Credits",
"refreshes_at": "2026-12-01T00:00:00Z",
"remaining": 1180.0
}
],
"count": 1
}Get current user
Get the Seamless.AI user the API key belongs to, and the credits your organization has left. Free.
Inputs
None.
Outputs
credits_remainingnumber- Credits your Seamless.AI organization has left after this step
emailtext- The email address the API key's user signs in with
first_nametext- The user's first name
last_nametext- The user's last name
Example output
{
"credits_remaining": 1180.0,
"email": "jo@example.com",
"first_name": "Jo",
"last_name": "Bloggs"
}List lists
List your Seamless.AI lists. Needs Public API v2.
Inputs
None.
Outputs
countnumber- How many are in this answer
listslist- The lists
Example output
{
"count": 1,
"lists": [
{
"createdAt": "2026-11-18T09:00:00Z",
"listId": "123",
"name": "Lodol leads",
"updatedAt": "2026-11-18T09:00:00Z"
}
]
}List researched companies
List the companies your organization researched in a time window, with their details. Free. Gets one page.
Inputs
- Researched from
start_datedate and time - The start of the window. Defaults to 24 hours before its end.
- Researched until
end_datedate and time - The end of the window. Defaults to now.
- Page
pagenumber - Which page to read, from 1.At least 1.
- Page size
limitnumber - How many per page, 1 to 500. Defaults to 100.From 1 to 500.
Outputs
companieslist- The companies found
countnumber- How many are in this answer
end_datetext- The end of the window read (ISO 8601)
has_moretrue/false- Whether there is another page
pagenumber- The page number read
start_datetext- The start of the window read (ISO 8601)
Example output
{
"companies": [
{
"companyId": "9120044",
"companyName": "Acme Corp",
"companyRevenue": "$20M - $50M",
"companySize": "201 - 500",
"companyType": "Private",
"createdAt": "2026-11-18T09:00:00Z",
"description": "Acme makes software for logistics teams.",
"domain": "acme.com",
"foundedOn": "2012",
"fundingTotal": "25000000",
"latestFundingDate": "2025-03-01",
"linkedInProfileUrl": "https://www.linkedin.com/company/acme",
"location": {
"city": "Austin",
"country": "United States",
"postCode": "78701",
"state": "Texas",
"street1": "100 Congress Ave"
},
"phones": "+1 512 555 0100",
"researchedAt": "2026-11-18T09:00:00Z",
"staffCount": "320",
"stockTicker": "",
"topTechnologies": "Salesforce, HubSpot",
"updatedAt": "2026-11-18T09:00:00Z"
}
],
"count": 1,
"end_date": "2026-11-18T09:00:00Z",
"has_more": false,
"page": 1,
"start_date": "2026-11-17T09:00:00Z"
}List researched contacts
List the people your organization researched in a time window, from the app, the Chrome extension or here, with their emails and phones. Free. Gets one page.
Inputs
- Researched from
start_datedate and time - The start of the window. Defaults to 24 hours before its end.
- Researched until
end_datedate and time - The end of the window. Defaults to now.
- Page
pagenumber - Which page to read, from 1.At least 1.
- Page size
limitnumber - How many per page, 1 to 500. Defaults to 100.From 1 to 500.
Outputs
contactslist- The people found
countnumber- How many are in this answer
end_datetext- The end of the window read (ISO 8601)
has_moretrue/false- Whether there is another page
pagenumber- The page number read
start_datetext- The start of the window read (ISO 8601)
Example output
{
"contacts": [
{
"city": "Austin",
"companyDomain": "acme.com",
"companyName": "Acme Corp",
"companyPhone1": "+1 512 555 0100",
"companyRevenue": "$20M - $50M",
"companySize": "201 - 500",
"contactId": "48213377",
"contactPhone1": "+1 512 555 0199",
"contactPhone1DataType": "mobile",
"country": "United States",
"createdAt": "2026-11-18T09:00:00Z",
"department": "Sales",
"email": "jane.doe@acme.com",
"email1EmailAI": "valid",
"firstName": "Jane",
"fullName": "Jane Doe",
"jobChangeAlert": "",
"jobTitle": "VP of Sales",
"lIProfileUrl": "https://www.linkedin.com/in/janedoe",
"lastName": "Doe",
"personalEmail": "",
"researchedAt": "2026-11-18T09:00:00Z",
"researchedTypes": [
"email",
"phone"
],
"seniority": "VP",
"state": "Texas",
"tags": [
"Lodol leads"
],
"updatedAt": "2026-11-18T09:00:00Z"
}
],
"count": 1,
"end_date": "2026-11-18T09:00:00Z",
"has_more": false,
"page": 1,
"start_date": "2026-11-17T09:00:00Z"
}Look up location
Find the exact spelling of a city, state, country or postal code to use in a search's locations, most common first. Free.
Inputs
- Place
querytextRequired - The start of a place name, such as york for New York.
- Kinds of place
location_typeslist - Only these kinds. Leave empty for all.One or more of:
city-state-country(City),state-country(State or region),city-country(City (no state)),country,postcode(Postal code). - How many
limitnumber - How many places to return, 1 to 100. Defaults to 10.From 1 to 100.
Outputs
countnumber- How many are in this answer
locationslist- The matching places, most people first
Example output
{
"count": 1,
"locations": [
{
"count": 412000,
"location": "Austin, Texas, United States",
"type": "city-state-country"
}
]
}Rename list
Give a list a new name. Needs Public API v2.
Inputs
- List
list_idtextRequired - The list. Pick one, or give its ID from an earlier step.
- Name
nametextRequired - The list's name. Each of your lists needs a different name.
Outputs
listobject- The list
list_idtext- The list's ID
Example output
{
"list": {
"createdAt": "2026-11-18T09:00:00Z",
"listId": "123",
"name": "Lodol leads",
"updatedAt": "2026-11-18T09:00:00Z"
},
"list_id": "123"
}Research companies
Start researching up to 500 companies from search results, websites or names, and get a request ID for each. Read the results with 'Get company research results'. Costs 1 credit per company.
Inputs
- Search result IDs
search_result_idslist - The 'searchResultId' of each company, from 'Search companies'.
- Websites
domainslist - Website domains of companies to research.
- Company names
company_nameslist - Names of companies to research.
- Research again even if recent
skip_duplicate_checktrue/false - Research it again, and pay again, even when your organization researched it in the last few minutes.
Outputs
countnumber- How many are in this answer
credits_remainingnumber- Credits your Seamless.AI organization has left after this step
request_idslist- One research request ID per record, to read the results
Example output
{
"count": 1,
"credits_remaining": 1180.0,
"request_ids": [
"zfojB7c6brQ0fIGrCvwHT"
]
}Research company
Get a company's details (phones, address, size, revenue, technologies and funding) from its website or name, and wait up to 90 seconds for the result. Costs 1 credit.
Inputs
- Website
domaintext - The company's website domain, such as acme.com.
- Company name
company_nametext - The company's name, when you don't have its website.
- Research again even if recent
skip_duplicate_checktrue/false - Research it again, and pay again, even when your organization researched it in the last few minutes.
Outputs
companyobject- The company's researched details; empty until done
credits_remainingnumber- Credits your Seamless.AI organization has left after this step
finishedtrue/false- Whether the research had finished when the step ended
foundtrue/false- Whether details came back
messagetext- Seamless.AI's note about the result, if any
request_idtext- The research request's ID, to read its result later
statustext- Where the research stands: queued, researching, done, duplicate (already researched), not found, error or missing
Example output
{
"company": {
"companyId": "9120044",
"companyName": "Acme Corp",
"companyRevenue": "$20M - $50M",
"companySize": "201 - 500",
"companyType": "Private",
"createdAt": "2026-11-18T09:00:00Z",
"description": "Acme makes software for logistics teams.",
"domain": "acme.com",
"foundedOn": "2012",
"fundingTotal": "25000000",
"latestFundingDate": "2025-03-01",
"linkedInProfileUrl": "https://www.linkedin.com/company/acme",
"location": {
"city": "Austin",
"country": "United States",
"postCode": "78701",
"state": "Texas",
"street1": "100 Congress Ave"
},
"phones": "+1 512 555 0100",
"researchedAt": "2026-11-18T09:00:00Z",
"staffCount": "320",
"stockTicker": "",
"topTechnologies": "Salesforce, HubSpot",
"updatedAt": "2026-11-18T09:00:00Z"
},
"credits_remaining": 1180.0,
"finished": true,
"found": true,
"message": "",
"request_id": "zfojB7c6brQ0fIGrCvwHT",
"status": "done"
}Research contact
Get one person's verified emails, phone numbers and job details, from a search result, their email, their LinkedIn link, or their name and company, and wait up to 90 seconds for the result. Spends credits: by default 1 for email, 5 for phone, 6 for both. Can also find their job change.
Inputs
- Search result ID
search_result_idtext - A person's 'searchResultId' from 'Search contacts'. Or leave it empty and give their email, LinkedIn link, or name and company.
- Email
emailtext - The person's email address.
- LinkedIn link
linkedin_urltext - Their LinkedIn, Sales Navigator or Recruiter profile link.
- Name
contact_nametext - The person's full name, with their company or website.
- Company
company_nametext - The company they work at, with their name.
- Company website
domaintext - The company's website domain, instead of its name.
- Job title
titletext - Their job title, to find the right job change.
- Look for a job change
is_job_changetrue/false - Find where the person works now, with their new title and details. Needs their details rather than a search result ID.
- Contact data to find
research_typeslist - Email costs 1 credit, phone 5, both 6 (by default). Leave empty for what your Seamless.AI Contact Data settings choose.One or more of:
email,phone. - Lists
list_idslist - Lists to put the researched people on. Needs Public API v2.
- Research again even if recent
skip_duplicate_checktrue/false - Research it again, and pay again, even when your organization researched it in the last few minutes.
Outputs
contactobject- The person's researched details; empty until done
credits_remainingnumber- Credits your Seamless.AI organization has left after this step
finishedtrue/false- Whether the research had finished when the step ended
foundtrue/false- Whether details came back
messagetext- Seamless.AI's note about the result, if any
request_idtext- The research request's ID, to read its result later
statustext- Where the research stands: queued, researching, done, duplicate (already researched), not found, error or missing
Example output
{
"contact": {
"city": "Austin",
"companyDomain": "acme.com",
"companyName": "Acme Corp",
"companyPhone1": "+1 512 555 0100",
"companyRevenue": "$20M - $50M",
"companySize": "201 - 500",
"contactId": "48213377",
"contactPhone1": "+1 512 555 0199",
"contactPhone1DataType": "mobile",
"country": "United States",
"createdAt": "2026-11-18T09:00:00Z",
"department": "Sales",
"email": "jane.doe@acme.com",
"email1EmailAI": "valid",
"firstName": "Jane",
"fullName": "Jane Doe",
"jobChangeAlert": "",
"jobTitle": "VP of Sales",
"lIProfileUrl": "https://www.linkedin.com/in/janedoe",
"lastName": "Doe",
"personalEmail": "",
"researchedAt": "2026-11-18T09:00:00Z",
"researchedTypes": [
"email",
"phone"
],
"seniority": "VP",
"state": "Texas",
"tags": [
"Lodol leads"
],
"updatedAt": "2026-11-18T09:00:00Z"
},
"credits_remaining": 1180.0,
"finished": true,
"found": true,
"message": "",
"request_id": "zfojB7c6brQ0fIGrCvwHT",
"status": "done"
}Research contacts
Start researching up to 500 people from search results, emails or LinkedIn links, and get a request ID for each. Read the results with 'Get contact research results'. Spends credits for each person: by default 1 for email, 5 for phone, 6 for both.
Inputs
- Search result IDs
search_result_idslist - The 'searchResultId' of each person, from 'Search contacts'.
- Emails
emailslist - Email addresses of people to research.
- LinkedIn links
linkedin_urlslist - LinkedIn profile links of people to research.
- Contact data to find
research_typeslist - Email costs 1 credit, phone 5, both 6 (by default). Leave empty for what your Seamless.AI Contact Data settings choose.One or more of:
email,phone. - Lists
list_idslist - Lists to put the researched people on. Needs Public API v2.
- Research again even if recent
skip_duplicate_checktrue/false - Research it again, and pay again, even when your organization researched it in the last few minutes.
Outputs
countnumber- How many are in this answer
credits_remainingnumber- Credits your Seamless.AI organization has left after this step
request_idslist- One research request ID per record, to read the results
Example output
{
"count": 1,
"credits_remaining": 1180.0,
"request_ids": [
"zfojB7c6brQ0fIGrCvwHT"
]
}Search companies
Find companies by name, website, place, industry, size, revenue, technology and funding. Costs 1 credit for every 50 companies returned. Gets one page; run it again with the next page it gives for more.
Inputs
- Companies
company_nameslist - Company names to match.
- Company websites
company_domainslist - Company website domains to match.
- Locations
locationslist - Cities, states or countries, up to 10. Use 'Look up location' for the exact spelling: a misspelled place matches nobody.
- Industries
industrieslist - The company's industries.One or more of:
Accounting,Airlines/Aviation,Alternative Dispute Resolution,Alternative Medicine,Animation,Apparel & Fashion,Architecture & Planning,Arts and Crafts,Automotive,Aviation & Aerospace, and 137 more. - Company size
company_sizeslist - Number of employees. Choose up to 10.One or more of:
0 - 1 (Self-employed),2 - 10,11 - 50,51 - 200,201 - 500,501 - 1,000,1,001 - 5,000,5,001 - 10,000,10,001+. - Company revenue
company_revenueslist - Estimated yearly revenue. Choose up to 10.One or more of:
$0 - $100K,$100K - $1M,$1M - $5M,$5M - $20M,$20M - $50M,$50M - $100M,$100M - $500M,$500M - $1B,$1B+. - Technologies
technologieslist - Only companies using any of these tools.
- Keywords
keywordslist - Words in the company's profile. All must match.
- Company type
company_typetext - Public (listed on a stock exchange) or private.One of:
Public,Private. - Founded
foundedlist - How long ago the company was founded.One or more of:
Less than 1 Year,Last 1-3 Years,Last 4-10 Years,10+ Years. - Latest funding round
funding_roundslist - The company's latest funding round.One or more of:
Angel,Pre-Seed,Seed,Series A,Series B,Series C,Series D,Series E,Series F,Series G, and 4 more. - How many
limitnumber - How many to return, 1 to 500. Seamless.AI's default is 50. Each 50 results, or part of 50, costs 1 credit.From 1 to 500.
- Next page
next_tokentext - The 'next_token' from an earlier run of this step, for the page after it.
Outputs
companieslist- The companies found
countnumber- How many are in this answer
credits_remainingnumber- Credits your Seamless.AI organization has left after this step
has_moretrue/false- Whether there is another page
next_tokentext- Give this to the same step to get the next page; empty if none
totalnumber- How many match in all
warningslist- Location filters that matched nowhere, with real spellings
Example output
{
"companies": [
{
"city": "Austin",
"companyName": "Acme Corp",
"companyRevenue": "$20M - $50M",
"companySize": "201 - 500",
"country": "United States",
"description": "Acme makes software for logistics teams.",
"domain": "acme.com",
"industries": [
"Computer Software"
],
"liUrl": "https://www.linkedin.com/company/acme",
"searchResultId": "sr_c91b2d",
"state": "Texas",
"technologies": [
"Salesforce",
"HubSpot"
]
}
],
"count": 1,
"credits_remaining": 1180.0,
"has_more": true,
"next_token": "eyJwYWdlIjoyfQ",
"total": 1240,
"warnings": [
{
"field": "locations",
"message": "No location matches 'Austn'.",
"suggestions": [
{
"count": 412000,
"location": "Austin, Texas, United States",
"type": "city-state-country"
}
],
"value": "Austn"
}
]
}Search contacts
Find people by job title, seniority, department, company, place, industry and more. Results have no emails or phones: research them to get those. Costs 1 credit for every 50 people returned. Gets one page; run it again with the next page it gives for more.
Inputs
- Job titles
job_titleslist - Titles to match. 'VP of Sales' also matches 'Vice President, Sales'.
- Exact titles only
titles_exact_matchtrue/false - Match the job titles exactly, rather than similar titles too.
- Seniority
senioritylist - Choose up to 5.One or more of:
C-Level,VP,Director,Manager,Senior,Mid-Level,Entry Level,Other. - Departments
departmentslist - Choose up to 5.One or more of:
Sales,Marketing,Engineering,Human Resources,Finance,IT,Operations,Support,Legal,Project Management,Other. - Companies
company_nameslist - Company names to match.
- Company websites
company_domainslist - Company website domains to match.
- Locations
locationslist - Cities, states or countries, up to 10. Use 'Look up location' for the exact spelling: a misspelled place matches nobody.
- Industries
industrieslist - The company's industries.One or more of:
Aerospace & Defense,Airlines & Aviation,Aviation & Aerospace,Defense & Space,Military,Agriculture,Farming,Horticulture,Ranching,Tobacco, and 166 more. - Company size
company_sizeslist - Number of employees. Choose up to 10.One or more of:
0 - 1 (Self-employed),2 - 10,11 - 50,51 - 200,201 - 500,501 - 1,000,1,001 - 5,000,5,001 - 10,000,10,001+. - Company revenue
company_revenueslist - Estimated yearly revenue. Choose up to 10.One or more of:
$0 - $100K,$100K - $1M,$1M - $5M,$5M - $20M,$20M - $50M,$50M - $100M,$100M - $500M,$500M - $1B,$1B+. - Technologies
technologieslist - Only companies using any of these tools.
- Keywords
keywordslist - Words in the person's profile, such as skills. All must match.
- Names
full_nameslist - Find these people by full name.
- Recent job change
job_change_typetext - Only people who recently joined a company or were promoted.One of:
New Hire,New Promotion,New Hire or New Promotion. - Job change within
job_change_windowtext - How recent the job change is. Needs 'Recent job change'.One of:
Last 60 Days,Last 90 Days,Last 180 Days,Last 365 Days. - How many
limitnumber - How many to return, 1 to 500. Seamless.AI's default is 50. Each 50 results, or part of 50, costs 1 credit.From 1 to 500.
- Next page
next_tokentext - The 'next_token' from an earlier run of this step, for the page after it.
Outputs
contactslist- The people found
countnumber- How many are in this answer
credits_remainingnumber- Credits your Seamless.AI organization has left after this step
has_moretrue/false- Whether there is another page
next_tokentext- Give this to the same step to get the next page; empty if none
totalnumber- How many match in all
warningslist- Location filters that matched nowhere, with real spellings
Example output
{
"contacts": [
{
"city": "Austin",
"companyName": "Acme Corp",
"companySize": "201 - 500",
"country": "United States",
"department": "Sales",
"domain": "acme.com",
"fullName": "Jane Doe",
"industries": [
"Computer Software"
],
"jobTitle": "VP of Sales",
"liUrl": "https://www.linkedin.com/in/janedoe",
"searchResultId": "sr_7f3c1a",
"seniority": "VP",
"state": "Texas"
}
],
"count": 1,
"credits_remaining": 1180.0,
"has_more": true,
"next_token": "eyJwYWdlIjoyfQ",
"total": 1240,
"warnings": [
{
"field": "locations",
"message": "No location matches 'Austn'.",
"suggestions": [
{
"count": 412000,
"location": "Austin, Texas, United States",
"type": "city-state-country"
}
],
"value": "Austn"
}
]
}Update company lists
Add researched companies to lists, remove them from lists, or make some lists their only ones. Needs Public API v2.
Inputs
- Company IDs
company_idslistRequired - The 'companyId' of each researched company, from 'List researched companies' or a trigger. Up to 500.
- Lists
list_idslist - The lists to apply. Leave empty only to take every list off.
- How
list_actiontext - Add to the lists, remove from them, or make them the only lists.One of:
add(Add to these lists),remove(Remove from these lists),replace(Make these their only lists). Default:add.
Outputs
list_actiontext- How the lists were applied: add, remove or replace
list_idslist- The lists applied
skipped_company_idslist- Companies left as they were (not yours, or no change)
updated_company_idslist- The companies that changed
Example output
{
"list_action": "add",
"list_ids": [
123
],
"skipped_company_ids": [
48213378
],
"updated_company_ids": [
48213377
]
}Update contact lists
Add researched contacts to lists, remove them from lists, or make some lists their only ones. Needs Public API v2.
Inputs
- Contact IDs
contact_idslistRequired - The 'contactId' of each researched contact, from 'List researched contacts' or a trigger. Up to 500.
- Lists
list_idslist - The lists to apply. Leave empty only to take every list off.
- How
list_actiontext - Add to the lists, remove from them, or make them the only lists.One of:
add(Add to these lists),remove(Remove from these lists),replace(Make these their only lists). Default:add.
Outputs
list_actiontext- How the lists were applied: add, remove or replace
list_idslist- The lists applied
skipped_contact_idslist- Contacts left as they were (not yours, or no change)
updated_contact_idslist- The contacts that changed
Example output
{
"list_action": "add",
"list_ids": [
123
],
"skipped_contact_ids": [
48213378
],
"updated_contact_ids": [
48213377
]
}