Sign in

v1

latestOpenAPI 3.0.02026-07-1390307.4 KB
Contact Search

Search contacts

post/search/contacts

Request body

nextTokenstring nullable

An opaque cursor token for retrieving the next page of results. Returned as supplementalData.nextToken in the previous response.

limitinteger

The maximum number of contacts to return per page. Must be a positive integer.

companyNamestring[]

Filter contacts by their company name. Accepts up to 100 company names.

companyNameSearchType'default' | 'related' | 'exact'

Controls how companyName values are matched. default matches the provided name using standard relevance matching. related broadens the search to include known subsidiaries, parent companies, and brand aliases. exact restricts results to only companies whose name is an exact match.

companyDomainstring[]

Filter contacts by their company's website domain. Accepts up to 100 domains.

contactStatestring[]

Filter by the contact's or company's state or region. Behavior depends on the locationType parameter. Sample enum values shown for documentation only; actual values are not exhaustive and come from the API or typeahead.

contactCountrystring[]

Filter by the contact's or company's country. Behavior depends on the locationType parameter. Sample enum values shown for documentation only; actual values are not exhaustive and come from the API or typeahead.

contactZipCodestring[]

Filter by the contact's or company's zip/postal code. Behavior depends on the locationType parameter. Sample enum values shown for documentation only; actual values are not exhaustive and come from the API or typeahead.

locationType'bothOR' | 'bothAND' | 'company' | 'contact'

Determines how location filters (contactState, contactCountry, contactZipCode) are applied. contact matches the contact's personal location only. company matches the company's headquarters location only. bothOR matches if either the contact or the company location matches (default). bothAND matches only when both the contact and the company location match.

departmentstring[]

Filter contacts by organizational department. Up to 5 departments can be specified.

industrystring[]

Filter contacts by their company's industry classification. Up to 5 industries can be specified. Values are organized into parent categories (e.g., "Software & Information Technology") and specific sub-industries (e.g., "Computer Software").

fullNamestring[]

Filter contacts by full name. Useful for finding specific individuals. Up to 10 names can be specified.

contactKeywordstring[]

Filter contacts by keyword matches against their profile (e.g., skills, bio, specialties). Up to 10 keywords can be specified.

jobTitlestring[]

Filter contacts by job title. Matches are based on relevance to the provided title strings. Up to 10 titles can be specified.

senioritystring[]

Filter contacts by seniority level within their organization. Up to 5 values can be specified.

companyFoundedOnstring[]

Filter contacts by how recently their company was founded. Up to 4 ranges can be specified.

companySizestring[]

Filter contacts by their company's employee count range. Up to 10 ranges can be specified.

companyRevenuestring[]

Filter contacts by their company's estimated annual revenue range. Up to 10 ranges can be specified.

technologiesstring[]

Filter contacts by technologies used at their company. Up to 10 technologies can be specified. Sample enum values shown for documentation only; actual values are not exhaustive and come from the API or typeahead.

technologiesIsOrboolean

Controls how multiple technologies values are combined. When true (default), returns contacts whose company uses any of the specified technologies (OR logic). When false, returns only contacts whose company uses all of the specified technologies (AND logic).

companyType'Public' | 'Private' nullable

Filter by company type. Public = companies with a known stock ticker/exchange, Private = all others.

lastModifiedAfterstring date-time

Return only contacts whose core data (name, title, company, phone, or email) was last updated on or after this date. Use ISO 8601 format.

lastModifiedBeforestring date-time

Return only contacts whose core data (name, title, company, phone, or email) was last updated on or before this date. Use ISO 8601 format. Combine with lastModifiedAfter to define a date range.

newsTypesstring[]

Filter contacts by recent news or events at their company. Returns contacts whose company has been associated with the specified event types. Up to 8 types can be specified.

newsTypeDatesstring[]

Restrict newsTypes results to a rolling window of recent days. Accepts a single value representing the number of days to look back. Only the first value is used if multiple are provided.

companyLatestFundingDatesstring[]

Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).

companyLatestFundingClassificationsstring[]

Filter companies based on the classifications of their latest funding round.

companyLatestFundingTotalsstring[]

Filter companies based on the total funding amount they have raised.

Example request

{
  "nextToken": null,
  "limit": 50,
  "contactCountry": [
    "United States"
  ],
  "contactZipCode": [
    "10001"
  ],
  "locationType": "bothOR",
  "department": [
    "IT",
    "Engineering"
  ],
  "industry": [
    "Software Development"
  ],
  "jobTitle": [
    "Chief Technology Officer"
  ],
  "seniority": [
    "C-Level",
    "VP"
  ],
  "companyFoundedOn": [
    "Last 4-10 Years"
  ],
  "companySize": [
    "201 - 500"
  ],
  "companyRevenue": [
    "$5M - $20M"
  ],
  "technologies": [
    "Salesforce"
  ],
  "technologiesIsOr": true,
  "lastModifiedAfter": "2025-09-01T11:00:00Z"
}

Response

Contact Search Results

Example response

{
  "data": [
    {
      "searchResultId": "708dbb34-3849-3c06-abd1-238b9a0295b3",
      "name": "Taylor Gonsalves",
      "company": "Seamless",
      "title": "Customer Success Manager, Mid Market Accounts",
      "department": "Sales",
      "seniority": "Manager",
      "domain": "seamless.ai",
      "city": "Jacksonville",
      "state": "Florida",
      "country": "United States",
      "companyCity": "Columbus",
      "companyState": "Ohio",
      "companyCountry": "United States",
      "liUrl": "https://www.linkedin.com/in/taylor-gonsalves-b9b18b196",
      "companyLIProfileUrl": "https://linkedin.com/company/seamlessai",
      "sicCode": "7389",
      "industries": [
        "Software Development",
        "Computer Software"
      ],
      "startedAtCurrentCompany": "2024-04-01",
      "titleStartedAt": "2024-04-01",
      "timeAtRole": "1 Yr 2 Mo",
      "timeAtCompany": "1 Yr 2 Mo",
      "companyFoundedOn": "2018-01-01",
      "lastModifiedAt": "2026-03-03 12:34:07",
      "companyRevenue": "$5M - $20M",
      "employeeSizeRange": "201 - 500",
      "timezone": "Eastern (EST)",
      "firstName": "Taylor",
      "middleName": "James",
      "lastName": "Gonsalves",
      "companyDomainAlias": "seamless.com",
      "contactLIRecruiterUrl": "https://www.linkedin.com/talent/search/profile/AEMAAC3xxOcBgZ5bzU1FB2g9fsiZ04QNuvnv51k",
      "contactLISalesNavUrl": "https://www.linkedin.com/sales/lead/ACoAAC3xxOcB-G4e6iCxOPRDtiJ5RKGoeWMqfFI,NAME_SEARCH",
      "contactXUrl": "https://twitter.com/taylorgonsalves",
      "companyGRURL": "https://www.google.com/search?q=Taylor%20Gonsalves%20Seamless",
      "contactCurrentCompanyYears": "2",
      "contactFBUrl": "https://www.facebook.com/public/Taylor+Gonsalves",
      "contactGURL": "https://www.google.com/search?q=Taylor+Gonsalves",
      "companyXUrl": "https://twitter.com/search?q=Seamless",
      "companyFBUrl": "https://www.facebook.com/search/top/?q=Seamless",
      "companyFundingTotal": "135000000",
      "companyLatestFundingDate": "2018-01-01",
      "companyLatestFundingClassifications": [
        "Series D"
      ],
      "companyType": "Public",
      "stockTicker": "AAPL"
    }
  ],
  "supplementalData": {
    "isMore": true,
    "total": 150,
    "perPage": 5,
    "nextToken": "eyJwYWdlIjoyLCJzZWFyY2hJZCI6ImFiYzEyMyJ9"
  }
}