Built-in tool

Search People

Search for people by role, company and location, returning one page; or replenish a People List from its saved search.

5 creditsNo API key needed

Endpoint

Parameters

NameTypeRequiredNote
jobTitlesarray · optionalarrayoptional

Current job titles to match.

Example: VP of Sales

jobTitlesExcludearray · optionalarrayoptional

Current job titles to leave out.

Example: Intern

seniorityLevelsarray · optionalarrayoptional

Seniority of the current role.

One of: c-team (C-Suite), vp (VP), director (Director), manager (Manager), staff (Staff), other (Other)

jobFunctionsarray · optionalarrayoptional

Department of the current role.

One of: sales & business development (Sales & Business Development), engineering (Engineering), advertising & marketing (Advertising & Marketing), other (Other), finance & accounting (Finance & Accounting), human resources (Human Resources), operations (Operations), art, culture and creative professionals (Art, Culture and Creative Professionals), legal (Legal), information technology (Information Technology) and 12 more

companiesListarray · optionalarrayoptional

Only people currently working at these companies, by company name. Matching is by name, so a common name can also match similarly named companies.

Example: Stripe

industriesarray · optionalarrayoptional

LinkedIn industry names of the person's current company.

Example: Software Development

companySizesarray · optionalarrayoptional

Employee-count bucket of the current company.

One of: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+

companyKeywordsarray · optionalarrayoptional

Keywords matched against the current company's profile.

Example: B2B SaaS

countriesarray · optionalarrayoptional

Countries the person is in, as names or ISO-2 codes.

Example: United States

citiesarray · optionalarrayoptional

Cities or regions the person is in.

Example: London

totalFundingMinnumber · optionalnumberoptional

Total funding the person's current company has raised, in USD.

Example: 5000000

totalFundingMaxnumber · optionalnumberoptional

Total funding the person's current company has raised, in USD.

Example: 100000000

lastFundingAmountMinnumber · optionalnumberoptional

Amount of the person's current company's most recent funding round, in USD.

Example: 2000000

lastFundingAmountMaxnumber · optionalnumberoptional

Amount of the person's current company's most recent funding round, in USD.

Example: 25000000

lastFundingYearMinnumber · optionalnumberoptional

Year of the person's current company's most recent funding round.

Example: 2024

lastFundingYearMaxnumber · optionalnumberoptional

Year of the person's current company's most recent funding round.

Example: 2026

lastFundingTypearray · optionalarrayoptional

Type of the person's current company's most recent funding round.

One of: Series unknown, Pre seed, Seed, Series A, Series B, Series C, Series D, Series E-J, Grant, Angel and 13 more

lastFundingTypeExcludearray · optionalarrayoptional

Types of most recent funding round to leave out.

One of: Series unknown, Pre seed, Seed, Series A, Series B, Series C, Series D, Series E-J, Grant, Angel and 13 more

investorsarray · optionalarrayoptional

Lead investors of the person's current company, by name.

Example: Sequoia Capital

limitnumber · optionalnumberoptional

Maximum results to return in this run (1-50). Each result costs 0.1 credits; an empty page costs nothing.

Default: 25

cursorstring · optionalstringoptional

Resume token from a previous run's meta.cursor, to fetch the next page of the same search. Leave empty to start from the first page.

listIdstring · optionalstringoptional

Replenish this People List from its saved search. Omit all filters and cursor. This changes Records and List membership.

targetNewnumber · optionalnumberoptional

With a saved People List, desired new members, no greater than the result limit. Duplicates and filtered profiles use that limit too.

Response schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "status",
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "title",
          "headline",
          "company",
          "company_domain",
          "company_linkedin_url",
          "location",
          "linkedin_url",
          "summary",
          "connections",
          "skills",
          "education",
          "certifications",
          "profile_photo_url"
        ],
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "skills": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "education": {
            "type": [
              "string",
              "null"
            ]
          },
          "connections": {
            "type": [
              "number",
              "null"
            ]
          },
          "linkedin_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "certifications": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_domain": {
            "type": [
              "string",
              "null"
            ]
          },
          "profile_photo_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_linkedin_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    },
    "meta": {
      "type": "object",
      "required": [
        "cursor",
        "hasMore",
        "returned",
        "totalCount",
        "actualCreditCost"
      ],
      "properties": {
        "cursor": {
          "type": [
            "string",
            "null"
          ]
        },
        "hasMore": {
          "type": "boolean"
        },
        "returned": {
          "type": "number"
        },
        "listImport": {
          "type": "string"
        },
        "totalCount": {
          "type": [
            "number",
            "null"
          ]
        },
        "actualCreditCost": {
          "type": "number"
        }
      },
      "additionalProperties": false
    },
    "status": {
      "type": "string",
      "const": "ok"
    },
    "replenishment": {
      "type": "object",
      "required": [
        "added",
        "recordIds",
        "addedRecordIds",
        "exhausted",
        "slicesRemaining",
        "needsNarrowing",
        "stalled",
        "budgetLimited",
        "stopReason",
        "returned",
        "pages",
        "httpAttempts",
        "listId"
      ],
      "properties": {
        "added": {
          "type": "integer",
          "minimum": 0
        },
        "pages": {
          "type": "integer",
          "maximum": 16,
          "minimum": 0
        },
        "listId": {
          "type": "string",
          "format": "uuid"
        },
        "stalled": {
          "type": "boolean"
        },
        "returned": {
          "type": "integer",
          "maximum": 50,
          "minimum": 0
        },
        "exhausted": {
          "type": "boolean"
        },
        "recordIds": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uuid"
          },
          "maxItems": 50
        },
        "stopReason": {
          "enum": [
            "target",
            "exhausted",
            "budget",
            "deadline",
            "needs_narrowing",
            "stalled",
            "failure"
          ],
          "type": "string"
        },
        "httpAttempts": {
          "type": "integer",
          "maximum": 8,
          "minimum": 0
        },
        "budgetLimited": {
          "type": "boolean"
        },
        "addedRecordIds": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uuid"
          },
          "maxItems": 50
        },
        "needsNarrowing": {
          "type": "boolean"
        },
        "slicesRemaining": {
          "type": "integer",
          "minimum": 0
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Get started

How to use this tool

  1. Connect your AI

    Add Connie to ChatGPT, Claude or Slack once, and this tool comes with it. There’s no API key or account to set up.

  2. Ask for the outcome

    Describe what you need in plain words. Your AI runs this tool when the job calls for it, along with any others it needs.

  3. Make it a workflow

    Add it as a step in a workflow that runs the same way every time, on a schedule or when something happens.

  4. Stay in control

    Choose whether it runs on its own or asks first. When it asks, you see an Allow or Deny card before any credits are spent.