# Seamless.AI

> 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.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/seamless-ai

## Actions

### Create list

Create a list to collect researched contacts and companies in. Needs Public API v2.

**Inputs**

- Name (`name`, text, required): The list's name. Each of your lists needs a different name.

**Outputs**

- `list` (object): The list
- `list_id` (text): The list's ID

**Example output**

```json
{
  "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_id`, text, required): The list. Pick one, or give its ID from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `list_id` (text): The list's ID

**Example output**

```json
{
  "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_ids`, list, required): The 'request_ids' a research step returned, up to 500.

**Outputs**

- `all_finished` (true/false): Whether none is still being researched
- `count` (number): How many are in this answer
- `done_count` (number): How many have finished with details
- `pending_count` (number): How many are still being researched
- `results` (list): Each research request and where it stands

**Example output**

```json
{
  "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_ids`, list, required): The 'request_ids' a research step returned, up to 500.

**Outputs**

- `all_finished` (true/false): Whether none is still being researched
- `count` (number): How many are in this answer
- `done_count` (number): How many have finished with details
- `pending_count` (number): How many are still being researched
- `results` (list): Each research request and where it stands

**Example output**

```json
{
  "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**

- `balances` (list): Credits left in each credit category
- `count` (number): How many are in this answer

**Example output**

```json
{
  "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_remaining` (number): Credits your Seamless.AI organization has left after this step
- `email` (text): The email address the API key's user signs in with
- `first_name` (text): The user's first name
- `last_name` (text): The user's last name

**Example output**

```json
{
  "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**

- `count` (number): How many are in this answer
- `lists` (list): The lists

**Example output**

```json
{
  "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_date`, date and time): The start of the window. Defaults to 24 hours before its end.
- Researched until (`end_date`, date and time): The end of the window. Defaults to now.
- Page (`page`, number): Which page to read, from 1. At least 1.
- Page size (`limit`, number): How many per page, 1 to 500. Defaults to 100. From 1 to 500.

**Outputs**

- `companies` (list): The companies found
- `count` (number): How many are in this answer
- `end_date` (text): The end of the window read (ISO 8601)
- `has_more` (true/false): Whether there is another page
- `page` (number): The page number read
- `start_date` (text): The start of the window read (ISO 8601)

**Example output**

```json
{
  "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_date`, date and time): The start of the window. Defaults to 24 hours before its end.
- Researched until (`end_date`, date and time): The end of the window. Defaults to now.
- Page (`page`, number): Which page to read, from 1. At least 1.
- Page size (`limit`, number): How many per page, 1 to 500. Defaults to 100. From 1 to 500.

**Outputs**

- `contacts` (list): The people found
- `count` (number): How many are in this answer
- `end_date` (text): The end of the window read (ISO 8601)
- `has_more` (true/false): Whether there is another page
- `page` (number): The page number read
- `start_date` (text): The start of the window read (ISO 8601)

**Example output**

```json
{
  "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 (`query`, text, required): The start of a place name, such as york for New York.
- Kinds of place (`location_types`, list): 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 (`limit`, number): How many places to return, 1 to 100. Defaults to 10. From 1 to 100.

**Outputs**

- `count` (number): How many are in this answer
- `locations` (list): The matching places, most people first

**Example output**

```json
{
  "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_id`, text, required): The list. Pick one, or give its ID from an earlier step.
- Name (`name`, text, required): The list's name. Each of your lists needs a different name.

**Outputs**

- `list` (object): The list
- `list_id` (text): The list's ID

**Example output**

```json
{
  "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_ids`, list): The 'searchResultId' of each company, from 'Search companies'.
- Websites (`domains`, list): Website domains of companies to research.
- Company names (`company_names`, list): Names of companies to research.
- Research again even if recent (`skip_duplicate_check`, true/false): Research it again, and pay again, even when your organization researched it in the last few minutes.

**Outputs**

- `count` (number): How many are in this answer
- `credits_remaining` (number): Credits your Seamless.AI organization has left after this step
- `request_ids` (list): One research request ID per record, to read the results

**Example output**

```json
{
  "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 (`domain`, text): The company's website domain, such as acme.com.
- Company name (`company_name`, text): The company's name, when you don't have its website.
- Research again even if recent (`skip_duplicate_check`, true/false): Research it again, and pay again, even when your organization researched it in the last few minutes.

**Outputs**

- `company` (object): The company's researched details; empty until done
- `credits_remaining` (number): Credits your Seamless.AI organization has left after this step
- `finished` (true/false): Whether the research had finished when the step ended
- `found` (true/false): Whether details came back
- `message` (text): Seamless.AI's note about the result, if any
- `request_id` (text): The research request's ID, to read its result later
- `status` (text): Where the research stands: queued, researching, done, duplicate (already researched), not found, error or missing

**Example output**

```json
{
  "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_id`, text): A person's 'searchResultId' from 'Search contacts'. Or leave it empty and give their email, LinkedIn link, or name and company.
- Email (`email`, text): The person's email address.
- LinkedIn link (`linkedin_url`, text): Their LinkedIn, Sales Navigator or Recruiter profile link.
- Name (`contact_name`, text): The person's full name, with their company or website.
- Company (`company_name`, text): The company they work at, with their name.
- Company website (`domain`, text): The company's website domain, instead of its name.
- Job title (`title`, text): Their job title, to find the right job change.
- Look for a job change (`is_job_change`, true/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_types`, list): 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_ids`, list): Lists to put the researched people on. Needs Public API v2.
- Research again even if recent (`skip_duplicate_check`, true/false): Research it again, and pay again, even when your organization researched it in the last few minutes.

**Outputs**

- `contact` (object): The person's researched details; empty until done
- `credits_remaining` (number): Credits your Seamless.AI organization has left after this step
- `finished` (true/false): Whether the research had finished when the step ended
- `found` (true/false): Whether details came back
- `message` (text): Seamless.AI's note about the result, if any
- `request_id` (text): The research request's ID, to read its result later
- `status` (text): Where the research stands: queued, researching, done, duplicate (already researched), not found, error or missing

**Example output**

```json
{
  "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_ids`, list): The 'searchResultId' of each person, from 'Search contacts'.
- Emails (`emails`, list): Email addresses of people to research.
- LinkedIn links (`linkedin_urls`, list): LinkedIn profile links of people to research.
- Contact data to find (`research_types`, list): 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_ids`, list): Lists to put the researched people on. Needs Public API v2.
- Research again even if recent (`skip_duplicate_check`, true/false): Research it again, and pay again, even when your organization researched it in the last few minutes.

**Outputs**

- `count` (number): How many are in this answer
- `credits_remaining` (number): Credits your Seamless.AI organization has left after this step
- `request_ids` (list): One research request ID per record, to read the results

**Example output**

```json
{
  "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_names`, list): Company names to match.
- Company websites (`company_domains`, list): Company website domains to match.
- Locations (`locations`, list): Cities, states or countries, up to 10. Use 'Look up location' for the exact spelling: a misspelled place matches nobody.
- Industries (`industries`, list): 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_sizes`, list): 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_revenues`, list): 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 (`technologies`, list): Only companies using any of these tools.
- Keywords (`keywords`, list): Words in the company's profile. All must match.
- Company type (`company_type`, text): Public (listed on a stock exchange) or private. One of: `Public`, `Private`.
- Founded (`founded`, list): 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_rounds`, list): 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 (`limit`, number): 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_token`, text): The 'next_token' from an earlier run of this step, for the page after it.

**Outputs**

- `companies` (list): The companies found
- `count` (number): How many are in this answer
- `credits_remaining` (number): Credits your Seamless.AI organization has left after this step
- `has_more` (true/false): Whether there is another page
- `next_token` (text): Give this to the same step to get the next page; empty if none
- `total` (number): How many match in all
- `warnings` (list): Location filters that matched nowhere, with real spellings

**Example output**

```json
{
  "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_titles`, list): Titles to match. 'VP of Sales' also matches 'Vice President, Sales'.
- Exact titles only (`titles_exact_match`, true/false): Match the job titles exactly, rather than similar titles too.
- Seniority (`seniority`, list): Choose up to 5. One or more of: `C-Level`, `VP`, `Director`, `Manager`, `Senior`, `Mid-Level`, `Entry Level`, `Other`.
- Departments (`departments`, list): Choose up to 5. One or more of: `Sales`, `Marketing`, `Engineering`, `Human Resources`, `Finance`, `IT`, `Operations`, `Support`, `Legal`, `Project Management`, `Other`.
- Companies (`company_names`, list): Company names to match.
- Company websites (`company_domains`, list): Company website domains to match.
- Locations (`locations`, list): Cities, states or countries, up to 10. Use 'Look up location' for the exact spelling: a misspelled place matches nobody.
- Industries (`industries`, list): 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_sizes`, list): 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_revenues`, list): 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 (`technologies`, list): Only companies using any of these tools.
- Keywords (`keywords`, list): Words in the person's profile, such as skills. All must match.
- Names (`full_names`, list): Find these people by full name.
- Recent job change (`job_change_type`, text): 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_window`, text): 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 (`limit`, number): 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_token`, text): The 'next_token' from an earlier run of this step, for the page after it.

**Outputs**

- `contacts` (list): The people found
- `count` (number): How many are in this answer
- `credits_remaining` (number): Credits your Seamless.AI organization has left after this step
- `has_more` (true/false): Whether there is another page
- `next_token` (text): Give this to the same step to get the next page; empty if none
- `total` (number): How many match in all
- `warnings` (list): Location filters that matched nowhere, with real spellings

**Example output**

```json
{
  "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_ids`, list, required): The 'companyId' of each researched company, from 'List researched companies' or a trigger. Up to 500.
- Lists (`list_ids`, list): The lists to apply. Leave empty only to take every list off.
- How (`list_action`, text): 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_action` (text): How the lists were applied: add, remove or replace
- `list_ids` (list): The lists applied
- `skipped_company_ids` (list): Companies left as they were (not yours, or no change)
- `updated_company_ids` (list): The companies that changed

**Example output**

```json
{
  "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_ids`, list, required): The 'contactId' of each researched contact, from 'List researched contacts' or a trigger. Up to 500.
- Lists (`list_ids`, list): The lists to apply. Leave empty only to take every list off.
- How (`list_action`, text): 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_action` (text): How the lists were applied: add, remove or replace
- `list_ids` (list): The lists applied
- `skipped_contact_ids` (list): Contacts left as they were (not yours, or no change)
- `updated_contact_ids` (list): The contacts that changed

**Example output**

```json
{
  "list_action": "add",
  "list_ids": [
    123
  ],
  "skipped_contact_ids": [
    48213378
  ],
  "updated_contact_ids": [
    48213377
  ]
}
```
