Evaboot API
  • Documentation
  • API Reference
Information
LinkedIn Extraction
    Extract a Sales Navigator search or listpostExtract a single Sales Navigator profilepostExtract a list of Sales Navigator profilespostGet LinkedIn extraction job resultsgetList LinkedIn extraction jobsget
Email Finder
    Find an emailpostList Email Finder jobsgetFind emails in bulkpostGet Email Finder job resultsget
Email Verifier
    Verify an emailpostList email validation jobsgetVerify emails in bulkpostGet email validation job resultsget
Account
    Get user quota informationget
Search Builder
    Generate a Sales Navigator search URLpost
Schemas
powered by Zudoku
Evaboot Public API
Evaboot Public API

Search Builder

Generate Sales Navigator search URLs from natural language


Generate a Sales Navigator search URL

POST
https://api.evaboot.com
/v1/search-builder/

Generate a LinkedIn Sales Navigator search URL from a natural language description.

Your description is translated into structured Sales Navigator filters (industry, seniority, company size, region, etc.) and a valid URL is returned, together with a summary of the filters that were chosen. Use it to go from a description of your ideal customer to a search you can open in Sales Navigator or hand straight to the URL extraction endpoint.

The URL is built and returned in the same request: this endpoint is synchronous and there is no job to poll.

Costs no credits. Limited to 100 requests per day per user.

Supported filter types: INDUSTRY, COMPANY_HEADCOUNT, COMPANY_TYPE, SENIORITY_LEVEL, FUNCTION, REGION, COMPANY_HEADQUARTERS, CURRENT_TITLE, CURRENT_COMPANY, YEARS_AT_CURRENT_COMPANY, YEARS_IN_CURRENT_POSITION, ANNUAL_REVENUE.

Generate a Sales Navigator search URL › Request Body

SearchBuilderIn
description
​string · minLength: 10 · maxLength: 2000 · required

Plain-language description of the leads or accounts you want to find. Mention everything that matters (job titles, seniority, industry, company size, location, revenue) and it is mapped onto the matching Sales Navigator filters. Between 10 and 2000 characters.

Example: CTOs and VPs of Engineering at SaaS companies in the US with 50-200 employees
search_type
​string · enum

Which Sales Navigator search to build: "LEAD" for a people search, "ACCOUNT" for a company search.

Enum values:
LEAD
ACCOUNT
Example: LEAD
Default: LEAD

Generate a Sales Navigator search URL › Responses

OK

SearchBuilderOut
url
​string · required

The generated Sales Navigator search URL. Open it in Sales Navigator to review the results, or send it to the URL extraction endpoint to extract the leads it matches.

Example: https://www.linkedin.com/sales/search/people?query=(filters%3AList((type%3ASENIORITY_LEVEL%2Cvalues%3AList((id%3A310%2Ctext%3ACXO%2CselectionType%3AINCLUDED)))))
​object · required

Summary of the filters that were applied, so you can check the description was understood before running an extraction. Keyed by filter type, each value a list of the labels Sales Navigator shows; excluded values are prefixed with NOT , and a keywords key appears when free-text keywords were used.

Example: {"COMPANY_HEADCOUNT":["51-200"],"INDUSTRY":["Software Development"],"REGION":["United States"],"SENIORITY_LEVEL":["CXO"]}
success
​boolean

Always true on a successful response. Failed requests return an error object instead.

Example: true
Default: true
POST/v1/search-builder/
curl https://api.evaboot.com/v1/search-builder \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "description": "CTOs and VPs of Engineering at SaaS companies in the US with 50-200 employees", "search_type": "LEAD" }'
Example Request Body
{ "description": "CTOs and VPs of Engineering at SaaS companies in the US with 50-200 employees", "search_type": "LEAD" }
json
Example Responses
{ "success": true, "url": "https://www.linkedin.com/sales/search/people?query=(filters%3AList((type%3ASENIORITY_LEVEL%2Cvalues%3AList((id%3A310%2Ctext%3ACXO%2CselectionType%3AINCLUDED)))))", "filters_used": { "COMPANY_HEADCOUNT": [ "51-200" ], "INDUSTRY": [ "Software Development" ], "REGION": [ "United States" ], "SENIORITY_LEVEL": [ "CXO" ] } }
json
application/json

Account