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

ActionWhat it does
Create listCreate a list to collect researched contacts and companies in.
Delete listDelete a list.
Get company research resultsSee where each company research stands, with the company's details once it's done.
Get contact research resultsSee where each contact research stands, with the person's details once it's done.
Get credit balancesGet the credits left in each of your credit categories and when they refresh.
Get current userGet the Seamless.AI user the API key belongs to, and the credits your organization has left.
List listsList your Seamless.AI lists.
List researched companiesList the companies your organization researched in a time window, with their details.
List researched contactsList the people your organization researched in a time window, from the app, the Chrome extension or here, with their emails and phones.
Look up locationFind the exact spelling of a city, state, country or postal code to use in a search's locations, most common first.
Rename listGive a list a new name.
Research companiesStart researching up to 500 companies from search results, websites or names, and get a request ID for each.
Research companyGet 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 contactGet 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 contactsStart researching up to 500 people from search results, emails or LinkedIn links, and get a request ID for each.
Search companiesFind companies by name, website, place, industry, size, revenue, technology and funding.
Search contactsFind people by job title, seniority, department, company, place, industry and more.
Update company listsAdd researched companies to lists, remove them from lists, or make some lists their only ones.
Update contact listsAdd 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

NamenametextRequired
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

Listlist_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 IDsrequest_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 IDsrequest_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 fromstart_datedate and time
The start of the window. Defaults to 24 hours before its end.
Researched untilend_datedate and time
The end of the window. Defaults to now.
Pagepagenumber
Which page to read, from 1.At least 1.
Page sizelimitnumber
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 fromstart_datedate and time
The start of the window. Defaults to 24 hours before its end.
Researched untilend_datedate and time
The end of the window. Defaults to now.
Pagepagenumber
Which page to read, from 1.At least 1.
Page sizelimitnumber
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

PlacequerytextRequired
The start of a place name, such as york for New York.
Kinds of placelocation_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 manylimitnumber
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

Listlist_idtextRequired
The list. Pick one, or give its ID from an earlier step.
NamenametextRequired
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 IDssearch_result_idslist
The 'searchResultId' of each company, from 'Search companies'.
Websitesdomainslist
Website domains of companies to research.
Company namescompany_nameslist
Names of companies to research.
Research again even if recentskip_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

Websitedomaintext
The company's website domain, such as acme.com.
Company namecompany_nametext
The company's name, when you don't have its website.
Research again even if recentskip_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 IDsearch_result_idtext
A person's 'searchResultId' from 'Search contacts'. Or leave it empty and give their email, LinkedIn link, or name and company.
Emailemailtext
The person's email address.
LinkedIn linklinkedin_urltext
Their LinkedIn, Sales Navigator or Recruiter profile link.
Namecontact_nametext
The person's full name, with their company or website.
Companycompany_nametext
The company they work at, with their name.
Company websitedomaintext
The company's website domain, instead of its name.
Job titletitletext
Their job title, to find the right job change.
Look for a job changeis_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 findresearch_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.
Listslist_idslist
Lists to put the researched people on. Needs Public API v2.
Research again even if recentskip_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 IDssearch_result_idslist
The 'searchResultId' of each person, from 'Search contacts'.
Emailsemailslist
Email addresses of people to research.
LinkedIn linkslinkedin_urlslist
LinkedIn profile links of people to research.
Contact data to findresearch_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.
Listslist_idslist
Lists to put the researched people on. Needs Public API v2.
Research again even if recentskip_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

Companiescompany_nameslist
Company names to match.
Company websitescompany_domainslist
Company website domains to match.
Locationslocationslist
Cities, states or countries, up to 10. Use 'Look up location' for the exact spelling: a misspelled place matches nobody.
Industriesindustrieslist
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 sizecompany_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 revenuecompany_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+.
Technologiestechnologieslist
Only companies using any of these tools.
Keywordskeywordslist
Words in the company's profile. All must match.
Company typecompany_typetext
Public (listed on a stock exchange) or private.One of: Public, Private.
Foundedfoundedlist
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 roundfunding_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 manylimitnumber
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 pagenext_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 titlesjob_titleslist
Titles to match. 'VP of Sales' also matches 'Vice President, Sales'.
Exact titles onlytitles_exact_matchtrue/false
Match the job titles exactly, rather than similar titles too.
Senioritysenioritylist
Choose up to 5.One or more of: C-Level, VP, Director, Manager, Senior, Mid-Level, Entry Level, Other.
Departmentsdepartmentslist
Choose up to 5.One or more of: Sales, Marketing, Engineering, Human Resources, Finance, IT, Operations, Support, Legal, Project Management, Other.
Companiescompany_nameslist
Company names to match.
Company websitescompany_domainslist
Company website domains to match.
Locationslocationslist
Cities, states or countries, up to 10. Use 'Look up location' for the exact spelling: a misspelled place matches nobody.
Industriesindustrieslist
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 sizecompany_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 revenuecompany_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+.
Technologiestechnologieslist
Only companies using any of these tools.
Keywordskeywordslist
Words in the person's profile, such as skills. All must match.
Namesfull_nameslist
Find these people by full name.
Recent job changejob_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 withinjob_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 manylimitnumber
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 pagenext_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 IDscompany_idslistRequired
The 'companyId' of each researched company, from 'List researched companies' or a trigger. Up to 500.
Listslist_idslist
The lists to apply. Leave empty only to take every list off.
Howlist_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 IDscontact_idslistRequired
The 'contactId' of each researched contact, from 'List researched contacts' or a trigger. Up to 500.
Listslist_idslist
The lists to apply. Leave empty only to take every list off.
Howlist_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
  ]
}

On this page