> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search for leads

> Search for leads based on your Ideal Customer Profile (ICP). Retrieve leads by criteria or from specified companies.

Parallel requests limit: 50 requests

Recommended timeout: 180 seconds

# Use Case:

Build a targeted list of prospects for outreach campaigns

# Additional Information:

* 50 Parallel processing available (multiple threads)
* Supported locations:
  * [List of Supported Locations](https://docs.google.com/spreadsheets/d/1pNW018ALP5NIenl7nnke8tqJmMsOZGkVdtt1MO9_yQU/edit#gid=0).
  * In case of inputting a location which is not listed you will receive a `ValidationError` (free request), with Hint what location you need to edit.
* Personas rules: (see example request first)
  * Top-level `personas` is a list of persona tuples. Each persona is:
    `[name, functions, seniorities, prohibits, priority?]`
  * **name** (string, required) — identifier for the persona group. Returned
    on every matched lead as `linkedin_lead_persona`.
  * **functions** (list of strings, required) — job-function keywords, OR-combined.
    * Example: `["marketing", "sales"]` matches a lead whose title contains
      either "marketing" or "sales".
    * **Important**: only `functions` are pushed to the LinkedIn pre-filter.
      `seniorities` and `prohibits` are applied server-side after leads are
      fetched. A single narrow function (e.g. `["ceo"]`) may miss leads whose
      actual title is a language-equivalent (`"Geschäftsführer"`,
      `"Managing Director"`, `"Founder"`, etc.). For best recall pass all
      equivalents explicitly, e.g.
      `["ceo", "managing director", "geschäftsführer", "founder", "inhaber", "owner"]`.
    * Pre-processing before matching: lowercased, diacritics stripped
      (`unidecode`), stop-words removed (`or`, `and`, `of`, `in`, `at`),
      `IT` → `information technology`, `DIR` → `director`, common
      abbreviations auto-expanded (`ceo ↔ chief executive officer`, etc.).
    * Pass `[]` to skip function matching (any title passes the function check).
  * **seniorities** (list of strings, optional, default `[]`) — seniority
    keywords, OR-combined. Applied post-fetch.
    * Matching is per-entry token containment: every token of a seniority
      phrase must appear in the lead's job title (tokens split on whitespace).
      So `"Managing Director"` requires both `"managing"` and `"director"` to
      be present in the title.
    * Final persona match is logical AND between functions and seniorities:
      a lead passes iff at least one function **and** at least one seniority
      match.
    * Example: `functions=["marketing", "sales"]` and
      `seniorities=["Head", "Manager"]` match "Head of Marketing",
      "Head of Sales", "Manager of Marketing", "Manager of Sales".
    * Auto-expansions (case-insensitive):
      * `"vp"` → also matches `SVP`, `EVP`, `GVP`, `AVP`
      * `"chief"`, `"c-lvl"`, `"cxo"` → also match `Chief Officer`
      * `"manager+"` → expands to `Manager`, `Director`, `Head`, `VP`, `SVP`,
        `EVP`, `AVP`, `Chief Officer`
    * Pass `[]` to skip seniority matching.
  * **prohibits** (list of strings, optional, default `[]`) — exclusion
    keywords, OR-combined. If at least one of its tokens appears in the
    lead's job title, the lead is dropped.
  * **priority** (integer, optional, default `0`) — ranking used when
    `limit_by` is smaller than the number of matches. Lower value = higher
    priority; leads from higher-priority personas are returned first.
  * In case of bad input you will receive a `ValidationError` (free request),
    with a hint on what you need to edit.
  * More Persona *Bad Examples and Good Practise* [you can see here](https://docs.google.com/spreadsheets/d/1pNW018ALP5NIenl7nnke8tqJmMsOZGkVdtt1MO9_yQU/edit#gid=753174520)
* limit\_by rules:
  * Will return only N-strip of first leads that match input criteria
* company\_link supported formats:
  * [https://www.linkedin.com/company/reply-io](https://www.linkedin.com/company/reply-io)
  * [https://www.linkedin.com/company/reply-io/](https://www.linkedin.com/company/reply-io/)
  * linkedin.com/company/reply-io
  * [https://in.linkedin.com/company/reply-io](https://in.linkedin.com/company/reply-io)
  * [http://linkedin.com/company/reply-io](http://linkedin.com/company/reply-io)
  * linkedin.com/pub/...
  * linkedin.com/pub-profile/…
  * [http://www.linkedin.com/pub-profile/](http://www.linkedin.com/pub-profile/)...
  * [https://www.linkedin.com/company/18584851](https://www.linkedin.com/company/18584851) (sales id)
  * [https://www.linkedin.com/sales/company/18584851](https://www.linkedin.com/sales/company/18584851)
* company\_types:
  * `"Public Company"`, `"Educational"`, `"Self Employed"`, `"Government Agency"`
  * `"Non Profit"`, `"Self Owned"`, `"Privately Held"`, `"Partnership"`
* By default Generect is able to search up to linkedin limits (*2500 results*)
* Parameter `"company_locations"` - companies headquarters locations
* Parameter `"company_headcounts"` - headcounts of companies, vars - `["1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10 000+"]`
* Parameter `"exclude_names"` - skip leads by unformatted full name
* Parameter `"exclude_ids"` - skip leads by `sales_id` (list of LinkedIn Sales Navigator IDs)
* Parameter `"filter_empty_vars"` - skip leads if variables is empty/None/False
  * available - job\_started\_on, profile\_photo, started\_at\_position, company\_website
* Parameter `"group"` - list of groups id
* Parameter `"schools"` - list of schools id
* Parameter `"past_company_names"` - list of past company names
* Parameter `"years_in_company"` - list of ids by time in current company
* Parameter `"years_in_position"` - list of ids by time in current position
* Parameter `"linkedin_filter_link"` - allows you to use pre-built LinkedIn search URLs instead of specifying individual search criteria

Time ranges for `"years_in_company"` & `"years_in_position"`:

1. *"Less than 1 year"*
2. *"1 to 2 years"*
3. *"3 to 5 years"*
4. *"6 to 10 years"*
5. *"More than 10 years"*

## LinkedIn Filter Link Usage

The `linkedin_filter_link` parameter allows you to use a pre-built LinkedIn search URL instead of manually specifying individual search criteria. This is particularly useful when you have complex search filters already configured in LinkedIn.

### Supported LinkedIn URLs:

* **Sales Navigator People Search**: `https://www.linkedin.com/sales/search/people?query=...`
* **Regular LinkedIn People Search**: `https://www.linkedin.com/search/results/people/?keywords=...`

\#**How it works**
:

1. Create your desired search in LinkedIn (Sales Navigator or regular search)
2. Copy the URL from the browser address bar
3. Use this URL as the `linkedin_filter_link` parameter
4. The API will extract and apply the search filters from your URL

### Usage Example:

```json theme={null}
{
  "linkedin_filter_link": "https://www.linkedin.com/sales/search/people?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3Amarketing%2CfirstName%3A%2ClastName%3A%2Ctitle%3A%2Ccompany%3A%2Cschool%3A%2CcontactInterest%3A%2CnetworkDepth%3A%2Clanguage%3A%2Clocation%3A%2Cindustry%3A%2CcurrentCompany%3A%2CpastCompany%3A%2CprofileLanguage%3A%2CnonprofitInterest%3A%2CfortuneOrGlobal500Size%3A%2CsalesPersona%3A)",
  "limit_by": 100
}
```

### Important Notes:

* When using `linkedin_filter_link`, you don't need to specify other filter parameters (locations, company\_name, personas, etc.)
* Maximum limit when using `linkedin_filter_link` is 2400 results
* The URL must contain valid query parameters that can be parsed
* Both Sales Navigator and regular LinkedIn search URLs are supported

## Search by Company Name

You can search for leads by specifying the company name directly:

```json theme={null}
{
  "company_name": "Microsoft",
  "personas": [
    ["Marketing", ["marketing", "digital marketing"], [], []]
  ],
  "limit_by": 50
}
```

### Important Notes for Company Search:

* You must specify **exactly one** of: `company_id`, `company_link`, or `company_name`
* The API will automatically find the LinkedIn company profile based on the provided information
* If no exact company match is found, the search may return an error or empty results

## Search by Lead Criteria Only

For lead searches based purely on lead parameters without targeting a specific company, use the `without_company` parameter:

```json theme={null}
{
  "without_company": true,
  "locations": ["New York, New York, United States"],
  "personas": [
    ["Tech Leaders", ["CTO", "VP Engineering", "Tech Director"], ["VP", "Director"], []]
  ],
  "limit_by": 100
}
```

### How Lead Criteria Search Works:

1. Searches for leads based only on their individual characteristics (job titles, locations, experience, etc.)
2. Does not require specifying any company information (`company_id`, `company_link`, or `company_name`)
3. Useful for finding leads across all companies that match specific criteria
4. Higher limit of 2400 results available
5. May have usage restrictions based on your account plan

### Important Notes for Lead Criteria Search:

* `without_company: true` removes the requirement to specify company information
* Search is performed based entirely on lead parameters: personas, locations, seniority levels, etc.
* Maximum limit of 2400 results when using this mode
* May have daily usage limits depending on your subscription
* Cannot be used together with `company_id`, `company_link`, or `company_name`
* Ideal for broad prospecting across multiple companies based on lead profiles


## OpenAPI

````yaml post /api/linkedin/leads/by_icp/
openapi: 3.0.3
info:
  title: Generect API
  description: >-
    Welcome to the Generect API documentation. Here we will help you integrate
    and use our API.


    API base url: `api.generect.com`  

    Protocol: `HTTPS`


    # Authentication


    Firstly, add a `API Token` to the enviroment variables `auth_token` in
    `Settings` tab.


    # Rate limits


    Credits: You can request data depending on your data plan and credit
    balance. The default is 10000/month. The estimated number of credits to
    spend is based on the complexity of the query and the number of results. The
    amount spent can be increased by additional data flags in the queries.


    # Note


    _Ensure that you are add a "/" to the end of url._
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.generect.com
security:
  - apiKey: []
tags:
  - name: 1. Auth
    description: Login and get user info
  - name: 2. Transactions
    description: List of latest transactions in your account
  - name: 3. Leads
    description: Fetch information about leads by _link/name/ICP_.
  - name: 4. Companies
    description: Fetch information about companies by link/name/ICP.
paths:
  /api/linkedin/leads/by_icp/:
    post:
      tags:
        - 3. Leads
      summary: Get List of Leads by ICP
      description: >-
        Search for leads based on your Ideal Customer Profile (ICP). Retrieve
        leads by criteria or from specified companies.
      operationId: getListOfLeadsByIcp
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                company_link:
                  type: string
                  description: Use 'company_link' or 'company_id'. One of them is required
                company_id:
                  type: integer
                  description: Optional.
                locations:
                  type: array
                  items:
                    type: string
                personas:
                  type: array
                  items:
                    type: array
                    items:
                      oneOf:
                        - type: string
                        - type: array
                          items:
                            type: string
                    minItems: 4
                limit_by:
                  type: integer
                exclude_names:
                  type: array
                  items:
                    type: string
                exclude_ids:
                  type: array
                  items:
                    type: string
                  description: Optional, list of sales_id values to exclude from results.
                filter_empty_vars:
                  type: array
                  items:
                    type: string
                changed_jobs:
                  type: boolean
                  description: Optional, flag to specify if jobs have changed.
                posted_on_linkedin:
                  type: boolean
                  description: Optional, flag to specify if posted on LinkedIn.
                mentioned_in_news:
                  type: boolean
                  description: Optional, flag to specify if mentioned in news.
                lead_industries:
                  type: array
                  items:
                    type: string
                  description: Optional, list of industries.
                company_locations:
                  type: array
                  items:
                    type: string
                  description: Optional, company locations.
                company_headcounts:
                  type: array
                  items:
                    type: string
                  description: Optional, company headcounts.
                company_types:
                  type: array
                  items:
                    type: string
                  description: Optional, company types.
                past_company_names:
                  type: array
                  items:
                    type: string
                  description: Optional, list of past company names.
                years_in_company:
                  type: array
                  items:
                    type: integer
                  description: Optional, number of years in a company.
                years_in_position:
                  type: array
                  items:
                    type: integer
                  description: Optional, number of years in the position.
                groups:
                  type: array
                  items:
                    type: integer
                  description: Optional, list of group IDs.
                schools:
                  type: array
                  items:
                    type: integer
                  description: Optional, list of school IDs.
                linkedin_filter_link:
                  type: string
                  description: >-
                    Optional, pre-built LinkedIn search URL (Sales Navigator or
                    regular search) containing search filters.
                without_company:
                  type: boolean
                  description: >-
                    Optional, set to true to search leads across all companies
                    without company restriction.
            examples:
              Get List of Leads by ICP:
                value:
                  company_link: https://www.linkedin.com/company/slack-technologies
                  locations:
                    - San Francisco, California, United States
                    - New York, New York, United States
                    - London, England, United Kingdom
                  personas:
                    - - Marketing Leaders
                      - - marketing
                        - digital marketing
                        - growth
                        - demand generation
                        - brand
                      - - Director
                        - VP
                        - Head
                        - Manager
                      - - intern
                        - coordinator
                        - specialist
                        - associate
                    - - Sales Executives
                      - - sales
                        - business development
                        - revenue
                        - enterprise sales
                        - account management
                      - - VP
                        - Director
                        - Head
                        - Manager
                      - - representative
                        - coordinator
                        - intern
                        - junior
                    - - Product Managers
                      - - product
                        - product management
                        - product marketing
                        - product strategy
                        - product operations
                      - - VP
                        - Director
                        - Head
                        - Senior
                      - - analyst
                        - coordinator
                        - intern
                        - associate
                  limit_by: 50
                  exclude_names:
                    - John Smith
                    - Sarah Johnson
                    - Michael Brown
                    - Emily Davis
                    - David Wilson
                    - Jennifer Garcia
                  filter_empty_vars:
                    - job_started_on
                    - profile_photo
              Get List of Leads using LinkedIn Filter Link:
                value:
                  linkedin_filter_link: >-
                    https://www.linkedin.com/sales/search/people?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3Amarketing%2CfirstName%3A%2ClastName%3A%2Ctitle%3A%2Ccompany%3A%2Cschool%3A%2CcontactInterest%3A%2CnetworkDepth%3A%2Clanguage%3A%2Clocation%3A%2Cindustry%3A%2CcurrentCompany%3A%2CpastCompany%3A%2CprofileLanguage%3A%2CnonprofitInterest%3A%2CfortuneOrGlobal500Size%3A%2CsalesPersona%3A)
                  limit_by: 100
              Get List of Leads by Company Name:
                value:
                  company_name: Microsoft
                  personas:
                    - - Marketing
                      - - marketing
                        - digital marketing
                      - []
                      - []
                  limit_by: 50
              Get List of Leads by Lead Criteria Only:
                value:
                  without_company: true
                  locations:
                    - New York, New York, United States
                  personas:
                    - - Tech Leaders
                      - - CTO
                        - VP Engineering
                        - Tech Director
                      - - VP
                        - Director
                      - []
                  limit_by: 100
      responses:
        '200':
          description: 200 / 200 (Leads not found)
          headers:
            Allow:
              schema:
                type: string
                example: POST, OPTIONS
            Content-Length:
              schema:
                type: string
                example: '70'
            Cross-Origin-Opener-Policy:
              schema:
                type: string
                example: same-origin
            Date:
              schema:
                type: string
                example: Mon, 02 Dec 2024 21:10:37 GMT
            Referrer-Policy:
              schema:
                type: string
                example: same-origin
            Server:
              schema:
                type: string
                example: WSGIServer/0.2 CPython/3.11.10
            Vary:
              schema:
                type: string
                example: Accept, Origin
            X-Content-Type-Options:
              schema:
                type: string
                example: nosniff
            X-Frame-Options:
              schema:
                type: string
                example: DENY
          content:
            application/json:
              schema:
                type: object
                properties:
                  amount:
                    type: number
                    example: -1
                  leads:
                    type: array
                    items:
                      type: object
                      properties:
                        certifications:
                          type: array
                          items: {}
                          example: []
                        company_city:
                          type: string
                          example: Schwarzenbek
                        company_country:
                          type: string
                          example: Germany
                        company_description:
                          type: string
                          example: >-
                            Slack is a business communication platform offering
                            persistent workplace chat, private groups, direct
                            messaging, file sharing, and application
                            integration.
                        company_headcount_range:
                          type: string
                          example: 501-1000
                        company_id:
                          type: string
                          example: '7590254'
                        company_image:
                          type: string
                          example: >-
                            https://media.licdn.com/dms/image/v2/D4E0BAQEuyU0O4IbVRQ/company-logo_200_200/company-logo_200_200/0/1720783130887/fette_compacting_gmbh_logo?e=1740009600&v=beta&t=jP_aJALpJhdsmjNIpbePqKkzUyp1-Qno9lWH9eV9g9M
                        company_industry:
                          type: string
                          example: Pharmaceutical Manufacturing
                        company_location:
                          type: string
                          example: Schwarzenbek, Schleswig-Holstein, Germany
                        company_name:
                          type: string
                          example: Slack
                        company_state:
                          type: string
                          example: Schleswig-Holstein
                        company_url:
                          nullable: true
                          example: null
                        company_website:
                          type: string
                          example: http://www.fette-compacting.com
                        educations:
                          type: array
                          items: {}
                          example: []
                        first_name:
                          type: string
                          example: Sarah
                        full_name:
                          type: string
                          example: Sarah Chen
                        headline:
                          type: string
                          example: Senior Marketing Director at Slack
                        industry:
                          type: string
                          example: Machinery Manufacturing
                        is_full_data:
                          type: boolean
                          example: true
                        is_job_seeker:
                          type: boolean
                          example: false
                        is_openlink:
                          type: boolean
                          example: false
                        is_premium:
                          type: boolean
                          example: false
                        is_retired:
                          type: boolean
                          example: false
                        job_description:
                          type: string
                          example: >-
                            Conception, elaboration and further development of
                            the global communication strategy (media, budget) as
                            a basis for decision-making for the management.
                            Advising global management on communication issues
                            such as change processes. Coordination, control and
                            implementation of the communication strategy
                            process: putting together international project
                            teams, participating in the communication strategy
                            process as an expert/adviser, writing speeches,
                            specialist articles, press releases, etc.,
                            controlling editorial activities, expanding press
                            work, further developing and implementing employer
                            branding activities. www.fette-compacting.com
                        job_ended_on:
                          nullable: true
                          example: null
                        job_location:
                          type: string
                          example: Schwarzenbek, Schleswig-Holstein, Deutschland
                        job_started_on:
                          type: string
                          example: Mar 2023
                        job_still_working:
                          type: boolean
                          example: true
                        job_title:
                          type: string
                          example: Senior Marketing Director
                        jobs:
                          type: array
                          items:
                            type: object
                            properties:
                              company_city:
                                type: string
                                example: Cincinnati
                              company_country:
                                type: string
                                example: United States
                              company_description:
                                type: string
                                example: >-
                                  ART WORKS IN ANDERSON LLC is a retail company
                                  based out of 1115 MAYCLIFFE PL, Cincinnati,
                                  Ohio, United States.
                              company_headcount_range:
                                type: string
                                example: 11-50
                              company_id:
                                type: string
                                example: '63587704'
                              company_image:
                                type: string
                                nullable: true
                                example: null
                              company_industry:
                                type: string
                                example: Retail
                              company_location:
                                type: string
                                example: Cincinnati, Ohio, United States
                              company_name:
                                type: string
                                example: Anderson Art Work / Self-employed
                              company_state:
                                type: string
                                example: Ohio
                              company_url:
                                type: string
                                example: >-
                                  https://www.linkedin.com/company/art-works-in-anderson-llc/
                              company_website:
                                type: string
                                example: http://cincinnatiartclasses.com
                              job_description:
                                type: string
                                example: |-
                                  http://www.andersonartwork.de/
                                  https://www.facebook.com/AndersonArtWork.de
                                  http://instagram.com/nicoleandersonartwork 
                                  http://www.pinterest.com/AndersonAW/
                              job_ended_on:
                                nullable: true
                                example: null
                              job_location:
                                type: string
                                example: Hamburg und Umgebung, Deutschland
                              job_started_on:
                                type: string
                                example: '2013'
                              job_still_working:
                                type: boolean
                                example: true
                              job_title:
                                type: string
                                example: Freelance Artist
                              raw_company_name:
                                type: string
                                example: Anderson Art Work / Self-employed
                              raw_job_title:
                                type: string
                                example: Freelance Artist
                          example:
                            - company_city: Cincinnati
                              company_country: United States
                              company_description: >-
                                ART WORKS IN ANDERSON LLC is a retail company
                                based out of 1115 MAYCLIFFE PL, Cincinnati,
                                Ohio, United States.
                              company_headcount_range: 11-50
                              company_id: '63587704'
                              company_image: null
                              company_industry: Retail
                              company_location: Cincinnati, Ohio, United States
                              company_name: Anderson Art Work / Self-employed
                              company_state: Ohio
                              company_url: >-
                                https://www.linkedin.com/company/art-works-in-anderson-llc/
                              company_website: http://cincinnatiartclasses.com
                              job_description: |-
                                http://www.andersonartwork.de/
                                https://www.facebook.com/AndersonArtWork.de
                                http://instagram.com/nicoleandersonartwork 
                                http://www.pinterest.com/AndersonAW/
                              job_ended_on: null
                              job_location: Hamburg und Umgebung, Deutschland
                              job_started_on: '2013'
                              job_still_working: true
                              job_title: Freelance Artist
                              raw_company_name: Anderson Art Work / Self-employed
                              raw_job_title: Freelance Artist
                            - company_city: San Francisco
                              company_country: United States
                              company_description: >-
                                Fette Compacting is the world's leading provider
                                of integrated solutions for industrial tablet
                                production.
                              company_headcount_range: 501-1000
                              company_id: '21828'
                              company_image: >-
                                https://media.licdn.com/dms/image/v2/D4E0BAQEuyU0O4IbVRQ/company-logo_400_400/company-logo_400_400/0/1720783130887/fette_compacting_gmbh_logo?e=1741219200&v=beta&t=HvwsgIyJYXepYTbSz8ySstMn8d3F9LgQtRtqEeLdqKI
                              company_industry: Software Development
                              company_location: San Francisco, California, United States
                              company_name: Slack
                              company_state: California
                              company_url: >-
                                https://www.linkedin.com/company/slack-technologies/
                              company_website: https://slack.com
                              job_description: >-
                                Lead global marketing strategy and demand
                                generation programs to drive customer
                                acquisition and retention. Oversee brand
                                positioning, content marketing, and digital
                                campaigns across all channels. Collaborate with
                                product, sales, and growth teams to accelerate
                                user adoption and revenue growth. Manage
                                marketing budget allocation and performance
                                metrics to optimize ROI and scale marketing
                                operations globally.
                              job_ended_on: null
                              job_location: San Francisco, California, United States
                              job_started_on: Mar 2023
                              job_still_working: true
                              job_title: Senior Marketing Director
                              raw_company_name: Slack
                              raw_job_title: Senior Marketing Director
                        languages:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                example: Englisch
                              proficiency:
                                type: string
                                example: FULL_PROFESSIONAL
                          example:
                            - name: Englisch
                              proficiency: FULL_PROFESSIONAL
                            - name: Deutsch
                              proficiency: NATIVE_OR_BILINGUAL
                        last_name:
                          type: string
                          example: Anderson
                        linkedin_company_id:
                          type: string
                          example: '7590254'
                        linkedin_id:
                          type: string
                          example: '80282110'
                        linkedin_lead_persona:
                          type: string
                          example: Marketing Leaders
                        linkedin_sales_link:
                          type: string
                          example: >-
                            https://www.linkedin.com/sales/lead/ACwAAATJAf4BWNxU442ZgFSJw2zzlmG6S3zv-e0,NAME_SEARCH,OJWs
                        linkedin_url:
                          type: string
                          example: https://www.linkedin.com/in/nicole-anderson-profile
                        location:
                          type: string
                          example: San Francisco, California, United States
                        location_city:
                          nullable: true
                          example: null
                        location_country:
                          type: string
                          example: Germany
                        location_county:
                          nullable: true
                          example: null
                        location_state:
                          type: string
                          example: Hamburg
                        middle_name:
                          type: string
                          example: ''
                        num_of_connections:
                          type: number
                          example: 710
                        private_website:
                          nullable: true
                          example: null
                        profile_photo:
                          type: string
                          example: >-
                            https://media.licdn.com/dms/image/v2/D4D03AQHdu7xNE9zgIw/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1724341778966?e=1738800000&v=beta&t=bEH4zW5MrIkRknwhvnOX5GQYRUOlIg9jib4wpsEWahE
                        raw_company_name:
                          type: string
                          example: Slack
                        raw_headline:
                          type: string
                          example: Senior Marketing Director at Slack
                        raw_job_title:
                          type: string
                          example: Senior Marketing Director
                        sales_id:
                          type: string
                          example: ACwAAATJAf4BWNxU442ZgFSJw2zzlmG6S3zv-e0
                        skills:
                          type: array
                          items: {}
                          example: []
                        summary:
                          type: string
                          example: >-
                            Experienced marketing leader with 8+ years driving
                            growth for B2B SaaS companies. Expert in demand
                            generation, content marketing, and marketing
                            automation platforms. Proven track record of scaling
                            marketing operations from startup to IPO, including
                            leading marketing teams of 20+ professionals.
                            Specialized in product marketing, customer lifecycle
                            campaigns, and conversion optimization.


                            Passionate about data-driven marketing, emerging
                            technologies, and building high-performing teams.
                        twitter_link:
                          nullable: true
                          example: null
                        unformatted_full_name:
                          type: string
                          example: Sarah Chen
                    example:
                      - certifications: []
                        company_city: San Francisco
                        company_country: United States
                        company_description: >-
                          Fette Compacting is the world's leading provider of
                          integrated solutions for industrial tablet production.
                        company_headcount_range: 501-1000
                        company_id: '21828'
                        company_image: >-
                          https://media.licdn.com/dms/image/v2/D4E0BAQEuyU0O4IbVRQ/company-logo_200_200/company-logo_200_200/0/1720783130887/fette_compacting_gmbh_logo?e=1740009600&v=beta&t=jP_aJALpJhdsmjNIpbePqKkzUyp1-Qno9lWH9eV9g9M
                        company_industry: Software Development
                        company_location: San Francisco, California, United States
                        company_name: Slack
                        company_state: California
                        company_url: null
                        company_website: https://slack.com
                        educations: []
                        first_name: Sarah
                        full_name: Sarah Chen
                        headline: Senior Marketing Director at Slack
                        industry: Software Development
                        is_full_data: true
                        is_job_seeker: false
                        is_openlink: false
                        is_premium: false
                        is_retired: false
                        job_description: >-
                          Lead global marketing strategy and demand generation
                          programs to drive customer acquisition and retention.
                          Oversee brand positioning, content marketing, and
                          digital campaigns across all channels. Collaborate
                          with product, sales, and growth teams to accelerate
                          user adoption and revenue growth. Manage marketing
                          budget allocation and performance metrics to optimize
                          ROI and scale marketing operations globally.
                        job_ended_on: null
                        job_location: San Francisco, California, United States
                        job_started_on: Mar 2023
                        job_still_working: true
                        job_title: Senior Marketing Director
                        jobs:
                          - company_city: Cincinnati
                            company_country: United States
                            company_description: >-
                              ART WORKS IN ANDERSON LLC is a retail company
                              based out of 1115 MAYCLIFFE PL, Cincinnati, Ohio,
                              United States.
                            company_headcount_range: 11-50
                            company_id: '63587704'
                            company_image: null
                            company_industry: Retail
                            company_location: Cincinnati, Ohio, United States
                            company_name: Anderson Art Work / Self-employed
                            company_state: Ohio
                            company_url: >-
                              https://www.linkedin.com/company/art-works-in-anderson-llc/
                            company_website: http://cincinnatiartclasses.com
                            job_description: |-
                              http://www.andersonartwork.de/
                              https://www.facebook.com/AndersonArtWork.de
                              http://instagram.com/nicoleandersonartwork 
                              http://www.pinterest.com/AndersonAW/
                            job_ended_on: null
                            job_location: Hamburg und Umgebung, Deutschland
                            job_started_on: '2013'
                            job_still_working: true
                            job_title: Freelance Artist
                            raw_company_name: Anderson Art Work / Self-employed
                            raw_job_title: Freelance Artist
                          - company_city: San Francisco
                            company_country: United States
                            company_description: >-
                              Fette Compacting is the world's leading provider
                              of integrated solutions for industrial tablet
                              production.
                            company_headcount_range: 501-1000
                            company_id: '21828'
                            company_image: >-
                              https://media.licdn.com/dms/image/v2/D4E0BAQEuyU0O4IbVRQ/company-logo_400_400/company-logo_400_400/0/1720783130887/fette_compacting_gmbh_logo?e=1741219200&v=beta&t=HvwsgIyJYXepYTbSz8ySstMn8d3F9LgQtRtqEeLdqKI
                            company_industry: Software Development
                            company_location: San Francisco, California, United States
                            company_name: Slack
                            company_state: California
                            company_url: >-
                              https://www.linkedin.com/company/slack-technologies/
                            company_website: https://slack.com
                            job_description: >-
                              Lead global marketing strategy and demand
                              generation programs to drive customer acquisition
                              and retention. Oversee brand positioning, content
                              marketing, and digital campaigns across all
                              channels. Collaborate with product, sales, and
                              growth teams to accelerate user adoption and
                              revenue growth. Manage marketing budget allocation
                              and performance metrics to optimize ROI and scale
                              marketing operations globally.
                            job_ended_on: null
                            job_location: San Francisco, California, United States
                            job_started_on: Mar 2023
                            job_still_working: true
                            job_title: Senior Marketing Director
                            raw_company_name: Slack
                            raw_job_title: Senior Marketing Director
                        languages:
                          - name: Englisch
                            proficiency: FULL_PROFESSIONAL
                          - name: Deutsch
                            proficiency: NATIVE_OR_BILINGUAL
                        last_name: Anderson
                        linkedin_company_id: '21828'
                        linkedin_id: '80282110'
                        linkedin_lead_persona: Marketing Leaders
                        linkedin_sales_link: >-
                          https://www.linkedin.com/sales/lead/ACwAAATJAf4BWNxU442ZgFSJw2zzlmG6S3zv-e0,NAME_SEARCH,OJWs
                        linkedin_url: https://www.linkedin.com/in/sarah-chen-marketing
                        location: San Francisco, California, United States
                        location_city: null
                        location_country: United States
                        location_county: null
                        location_state: California
                        middle_name: ''
                        num_of_connections: 710
                        private_website: null
                        profile_photo: >-
                          https://media.licdn.com/dms/image/v2/D4D03AQHdu7xNE9zgIw/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1724341778966?e=1738800000&v=beta&t=bEH4zW5MrIkRknwhvnOX5GQYRUOlIg9jib4wpsEWahE
                        raw_company_name: Slack
                        raw_headline: Senior Marketing Director at Slack
                        raw_job_title: Senior Marketing Director
                        sales_id: ACwAAATJAf4BWNxU442ZgFSJw2zzlmG6S3zv-e0
                        skills: []
                        summary: >-
                          Experienced marketing leader with 8+ years driving
                          growth for B2B SaaS companies. Expert in demand
                          generation, content marketing, and marketing
                          automation platforms. Proven track record of scaling
                          marketing operations from startup to IPO, including
                          leading marketing teams of 20+ professionals.
                          Specialized in product marketing, customer lifecycle
                          campaigns, and conversion optimization.


                          Passionate about data-driven marketing, emerging
                          technologies, and building high-performing teams.
                        twitter_link: null
                        unformatted_full_name: Sarah Chen
                  results_count:
                    type: string
                    example: within limit
                  status:
                    type: string
                    example: No leads match with input criteria
              examples:
                '200':
                  value:
                    amount: -1
                    leads:
                      - certifications: []
                        company_city: San Francisco
                        company_country: United States
                        company_description: >-
                          Fette Compacting is the world's leading provider of
                          integrated solutions for industrial tablet production.
                        company_headcount_range: 501-1000
                        company_id: '21828'
                        company_image: >-
                          https://media.licdn.com/dms/image/v2/D4E0BAQEuyU0O4IbVRQ/company-logo_200_200/company-logo_200_200/0/1720783130887/fette_compacting_gmbh_logo?e=1740009600&v=beta&t=jP_aJALpJhdsmjNIpbePqKkzUyp1-Qno9lWH9eV9g9M
                        company_industry: Software Development
                        company_location: San Francisco, California, United States
                        company_name: Slack
                        company_state: California
                        company_url: null
                        company_website: https://slack.com
                        educations: []
                        first_name: Sarah
                        full_name: Sarah Chen
                        headline: Senior Marketing Director at Slack
                        industry: Software Development
                        is_full_data: true
                        is_job_seeker: false
                        is_openlink: false
                        is_premium: false
                        is_retired: false
                        job_description: >-
                          Lead global marketing strategy and demand generation
                          programs to drive customer acquisition and retention.
                          Oversee brand positioning, content marketing, and
                          digital campaigns across all channels. Collaborate
                          with product, sales, and growth teams to accelerate
                          user adoption and revenue growth. Manage marketing
                          budget allocation and performance metrics to optimize
                          ROI and scale marketing operations globally.
                        job_ended_on: null
                        job_location: San Francisco, California, United States
                        job_started_on: Mar 2023
                        job_still_working: true
                        job_title: Senior Marketing Director
                        jobs:
                          - company_city: Cincinnati
                            company_country: United States
                            company_description: >-
                              ART WORKS IN ANDERSON LLC is a retail company
                              based out of 1115 MAYCLIFFE PL, Cincinnati, Ohio,
                              United States.
                            company_headcount_range: 11-50
                            company_id: '63587704'
                            company_image: null
                            company_industry: Retail
                            company_location: Cincinnati, Ohio, United States
                            company_name: Anderson Art Work / Self-employed
                            company_state: Ohio
                            company_url: >-
                              https://www.linkedin.com/company/art-works-in-anderson-llc/
                            company_website: http://cincinnatiartclasses.com
                            job_description: |-
                              http://www.andersonartwork.de/
                              https://www.facebook.com/AndersonArtWork.de
                              http://instagram.com/nicoleandersonartwork 
                              http://www.pinterest.com/AndersonAW/
                            job_ended_on: null
                            job_location: Hamburg und Umgebung, Deutschland
                            job_started_on: '2013'
                            job_still_working: true
                            job_title: Freelance Artist
                            raw_company_name: Anderson Art Work / Self-employed
                            raw_job_title: Freelance Artist
                          - company_city: San Francisco
                            company_country: United States
                            company_description: >-
                              Fette Compacting is the world's leading provider
                              of integrated solutions for industrial tablet
                              production.
                            company_headcount_range: 501-1000
                            company_id: '21828'
                            company_image: >-
                              https://media.licdn.com/dms/image/v2/D4E0BAQEuyU0O4IbVRQ/company-logo_400_400/company-logo_400_400/0/1720783130887/fette_compacting_gmbh_logo?e=1741219200&v=beta&t=HvwsgIyJYXepYTbSz8ySstMn8d3F9LgQtRtqEeLdqKI
                            company_industry: Software Development
                            company_location: San Francisco, California, United States
                            company_name: Slack
                            company_state: California
                            company_url: >-
                              https://www.linkedin.com/company/slack-technologies/
                            company_website: https://slack.com
                            job_description: >-
                              Lead global marketing strategy and demand
                              generation programs to drive customer acquisition
                              and retention. Oversee brand positioning, content
                              marketing, and digital campaigns across all
                              channels. Collaborate with product, sales, and
                              growth teams to accelerate user adoption and
                              revenue growth. Manage marketing budget allocation
                              and performance metrics to optimize ROI and scale
                              marketing operations globally.
                            job_ended_on: null
                            job_location: San Francisco, California, United States
                            job_started_on: Mar 2023
                            job_still_working: true
                            job_title: Senior Marketing Director
                            raw_company_name: Slack
                            raw_job_title: Senior Marketing Director
                        languages:
                          - name: Englisch
                            proficiency: FULL_PROFESSIONAL
                          - name: Deutsch
                            proficiency: NATIVE_OR_BILINGUAL
                        last_name: Anderson
                        linkedin_company_id: '21828'
                        linkedin_id: '80282110'
                        linkedin_lead_persona: Marketing Leaders
                        linkedin_sales_link: >-
                          https://www.linkedin.com/sales/lead/ACwAAATJAf4BWNxU442ZgFSJw2zzlmG6S3zv-e0,NAME_SEARCH,OJWs
                        linkedin_url: https://www.linkedin.com/in/sarah-chen-marketing
                        location: San Francisco, California, United States
                        location_city: null
                        location_country: United States
                        location_county: null
                        location_state: California
                        middle_name: ''
                        num_of_connections: 710
                        private_website: null
                        profile_photo: >-
                          https://media.licdn.com/dms/image/v2/D4D03AQHdu7xNE9zgIw/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1724341778966?e=1738800000&v=beta&t=bEH4zW5MrIkRknwhvnOX5GQYRUOlIg9jib4wpsEWahE
                        raw_company_name: Slack
                        raw_headline: Senior Marketing Director at Slack
                        raw_job_title: Senior Marketing Director
                        sales_id: ACwAAATJAf4BWNxU442ZgFSJw2zzlmG6S3zv-e0
                        skills: []
                        summary: >-
                          Experienced marketing leader with 8+ years driving
                          growth for B2B SaaS companies. Expert in demand
                          generation, content marketing, and marketing
                          automation platforms. Proven track record of scaling
                          marketing operations from startup to IPO, including
                          leading marketing teams of 20+ professionals.
                          Specialized in product marketing, customer lifecycle
                          campaigns, and conversion optimization.


                          Passionate about data-driven marketing, emerging
                          technologies, and building high-performing teams.
                        twitter_link: null
                        unformatted_full_name: Sarah Chen
                    results_count: within limit
                200 (Leads not found):
                  value:
                    amount: -1
                    leads: []
                    status: No leads match with input criteria
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: Use 'Token <api-key>' as the value

````