Leads finder

Search for people matching person and company filters.

Endpoint

POST https://api.airscale.io/v1/leads-finder

POST https://api.airscale.io/v1/leads-finder

POST https://api.airscale.io/v1/leads-finder

/v1/leads-finder/preview is also supported with the same request and response shape.

Headers

Key	Value	Required
Content-Type	application/json	Yes
Authorization	Bearer `<YOUR_API_KEY>`	Yes

Rate Limit and Credits

Rule	Value
Rate limit	2 requests per second per workspace/API key
Rate-limit response	`429 Too Many Requests`
Credit cost	0.1 credits per returned lead

Request Body

Minimal request

{
  "filters": {
    "job": ["Founder"],
    "company": "airscale.io",
    "peopleLocation": ["France"],
    "searchMode": "SMART"
  },
  "page": 0,
  "size": 25
}

{
  "filters": {
    "job": ["Founder"],
    "company": "airscale.io",
    "peopleLocation": ["France"],
    "searchMode": "SMART"
  },
  "page": 0,
  "size": 25
}

{
  "filters": {
    "job": ["Founder"],
    "company": "airscale.io",
    "peopleLocation": ["France"],
    "searchMode": "SMART"
  },
  "page": 0,
  "size": 25
}

Complete request with every filter

{
  "filters": {
    "job": ["Founder", "CEO", "VP Sales"],
    "jobExclude": ["Intern", "Assistant"],
    "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
    "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
    "peopleLocation": ["France", "Paris, France", "United States"],
    "peopleLocationExclude": ["India", "Brazil"],
    "seniority": "Founder\nC Suite\nVP\nDirector",
    "seniorityExclude": "Intern\nEntry",
    "yearsCurrentRole": "1 to 2 years",
    "yearsCurrentCompany": "3 to 5 years",
    "yearsWorkExperience": "More than 10 years",
    "skills": "lead generation\nsales automation\nprospecting",
    "skillsExclude": "customer support",
    "language": "English\nFrench",
    "languageExclude": "Russian",
    "certification": "HubSpot Sales Software\nSalesforce Administrator",
    "certificationExclude": "Google Ads",
    "profileKeywords": "growth\noutbound\nB2B",
    "profileKeywordsExclude": "student\nfreelance",
    "profileBadge": "Open to Work\nCreator",
    "industry": "software development\nit services and it consulting",
    "industryExclude": "staffing and recruiting",
    "size": "11-50",
    "hq": "Paris, France\nNew York, United States",
    "hqExclude": "San Francisco, United States",
    "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
    "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
    "revenue": "1000000-10000000",
    "companyKeywords": "sales automation\nlead enrichment",
    "companyKeywordsExclude": "agency\nconsulting",
    "founded": "2015-2022",
    "funding": "SEED\nSERIES_A",
    "fundingAmount": "1000000-5000000",
    "fundingDateMonths": "12",
    "department": "sales\n10-100",
    "growth": "sales\n20-80\n3 months",
    "searchMode": "SMART"
  },
  "page": 0,
  "size": 25
}

{
  "filters": {
    "job": ["Founder", "CEO", "VP Sales"],
    "jobExclude": ["Intern", "Assistant"],
    "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
    "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
    "peopleLocation": ["France", "Paris, France", "United States"],
    "peopleLocationExclude": ["India", "Brazil"],
    "seniority": "Founder\nC Suite\nVP\nDirector",
    "seniorityExclude": "Intern\nEntry",
    "yearsCurrentRole": "1 to 2 years",
    "yearsCurrentCompany": "3 to 5 years",
    "yearsWorkExperience": "More than 10 years",
    "skills": "lead generation\nsales automation\nprospecting",
    "skillsExclude": "customer support",
    "language": "English\nFrench",
    "languageExclude": "Russian",
    "certification": "HubSpot Sales Software\nSalesforce Administrator",
    "certificationExclude": "Google Ads",
    "profileKeywords": "growth\noutbound\nB2B",
    "profileKeywordsExclude": "student\nfreelance",
    "profileBadge": "Open to Work\nCreator",
    "industry": "software development\nit services and it consulting",
    "industryExclude": "staffing and recruiting",
    "size": "11-50",
    "hq": "Paris, France\nNew York, United States",
    "hqExclude": "San Francisco, United States",
    "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
    "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
    "revenue": "1000000-10000000",
    "companyKeywords": "sales automation\nlead enrichment",
    "companyKeywordsExclude": "agency\nconsulting",
    "founded": "2015-2022",
    "funding": "SEED\nSERIES_A",
    "fundingAmount": "1000000-5000000",
    "fundingDateMonths": "12",
    "department": "sales\n10-100",
    "growth": "sales\n20-80\n3 months",
    "searchMode": "SMART"
  },
  "page": 0,
  "size": 25
}

{
  "filters": {
    "job": ["Founder", "CEO", "VP Sales"],
    "jobExclude": ["Intern", "Assistant"],
    "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
    "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
    "peopleLocation": ["France", "Paris, France", "United States"],
    "peopleLocationExclude": ["India", "Brazil"],
    "seniority": "Founder\nC Suite\nVP\nDirector",
    "seniorityExclude": "Intern\nEntry",
    "yearsCurrentRole": "1 to 2 years",
    "yearsCurrentCompany": "3 to 5 years",
    "yearsWorkExperience": "More than 10 years",
    "skills": "lead generation\nsales automation\nprospecting",
    "skillsExclude": "customer support",
    "language": "English\nFrench",
    "languageExclude": "Russian",
    "certification": "HubSpot Sales Software\nSalesforce Administrator",
    "certificationExclude": "Google Ads",
    "profileKeywords": "growth\noutbound\nB2B",
    "profileKeywordsExclude": "student\nfreelance",
    "profileBadge": "Open to Work\nCreator",
    "industry": "software development\nit services and it consulting",
    "industryExclude": "staffing and recruiting",
    "size": "11-50",
    "hq": "Paris, France\nNew York, United States",
    "hqExclude": "San Francisco, United States",
    "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
    "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
    "revenue": "1000000-10000000",
    "companyKeywords": "sales automation\nlead enrichment",
    "companyKeywordsExclude": "agency\nconsulting",
    "founded": "2015-2022",
    "funding": "SEED\nSERIES_A",
    "fundingAmount": "1000000-5000000",
    "fundingDateMonths": "12",
    "department": "sales\n10-100",
    "growth": "sales\n20-80\n3 months",
    "searchMode": "SMART"
  },
  "page": 0,
  "size": 25
}

Field	Type	Required	Notes
`filters`	object	No	Defaults to `{}`
`filters.job`	array[string]	No	Current job titles to include. Example: `["Founder", "CEO", "VP Sales"]`
`filters.jobExclude`	array[string]	No	Current job titles to exclude. Example: `["Intern", "Assistant"]`
`filters.company`	string \| array[string]	No	Company name, domain, or LinkedIn company URL. Example: `["airscale.io", "OpenAI"]`
`filters.companyUrl`	string \| array[string]	No	Company domain or LinkedIn company URL. Example: `["airscale.io", "https://www.linkedin.com/company/openai"]`
`filters.peopleLocation`	string \| array[string]	No	Person locations to include. Example: `["France", "Paris, France"]`
`filters.peopleLocationExclude`	string \| array[string]	No	Person locations to exclude. Example: `["India", "Brazil"]`
`filters.seniority`	string	No	Comma- or newline-separated. Example: `Founder\nC Suite\nVP`
`filters.seniorityExclude`	string	No	Comma- or newline-separated. Example: `Intern\nEntry`
`filters.yearsCurrentRole`	string	No	Experience duration. Example: `1 to 2 years`
`filters.yearsCurrentCompany`	string	No	Experience duration. Example: `3 to 5 years`
`filters.yearsWorkExperience`	string	No	Experience duration. Example: `More than 10 years`
`filters.skills`	string	No	Comma- or newline-separated. Example: `lead generation\nsales automation`
`filters.skillsExclude`	string	No	Comma- or newline-separated. Example: `customer support`
`filters.language`	string	No	Comma- or newline-separated. Example: `English\nFrench`
`filters.languageExclude`	string	No	Comma- or newline-separated. Example: `Russian`
`filters.certification`	string	No	Comma- or newline-separated. Example: `HubSpot Sales Software\nSalesforce Administrator`
`filters.certificationExclude`	string	No	Comma- or newline-separated. Example: `Google Ads`
`filters.profileKeywords`	string	No	Searches headline, summary, skill, and certification. Example: `growth\noutbound\nB2B`
`filters.profileKeywordsExclude`	string	No	Excludes profile keywords. Example: `student\nfreelance`
`filters.profileBadge`	string	No	Comma- or newline-separated profile badges. Example: `Open to Work\nCreator`
`filters.industry`	string	No	Comma- or newline-separated company industries. Example: `software development\nit services and it consulting`
`filters.industryExclude`	string	No	Industries to exclude. Example: `staffing and recruiting`
`filters.size`	string	No	Company employee size range. Example: `11-50`
`filters.hq`	string	No	Company headquarters locations to include. Example: `Paris, France\nNew York, United States`
`filters.hqExclude`	string	No	Company headquarters locations to exclude. Example: `San Francisco, United States`
`filters.type`	string	No	Company types to include. Example: `PRIVATELY_HELD\nPUBLIC_COMPANY`
`filters.typeExclude`	string	No	Company types to exclude. Example: `GOVERNMENT_AGENCY\nNON_PROFIT`
`filters.revenue`	string	No	Company revenue range. Example: `1000000-10000000`
`filters.companyKeywords`	string	No	Searches company name, keyword, SEO, description, and industry. Example: `sales automation\nlead enrichment`
`filters.companyKeywordsExclude`	string	No	Excludes company keywords. Example: `agency\nconsulting`
`filters.founded`	string	No	Company founded year or range. Example: `2015-2022`
`filters.funding`	string	No	Funding rounds, comma- or newline-separated. Example: `SEED\nSERIES_A`
`filters.fundingAmount`	string	No	Last funding amount range. Example: `1000000-5000000`
`filters.fundingDateMonths`	string	No	Last funding date window in months. Example: `12`
`filters.department`	string	No	Department/function plus optional employee-count range. Example: `sales\n10-100`
`filters.growth`	string	No	Department/function plus growth range and optional month window. Example: `sales\n20-80\n3 months`
`filters.searchMode`	string	No	`SMART`, `WORD`, or `STRICT`. Defaults to `SMART`
`page`	integer	No	Must be `>= 0`. Defaults to `0`
`size`	integer	No	Must be `1..100`. Defaults to `50`

Filter example formats

Filter group	Example
Job titles	`"job": ["Founder", "CEO", "VP Sales"]`
Excluded job titles	`"jobExclude": ["Intern", "Assistant"]`
Company names/domains	`"company": ["airscale.io", "OpenAI"]`
Company LinkedIn/domain URLs	`"companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"]`
Person locations	`"peopleLocation": ["France", "Paris, France"]`
Excluded person locations	`"peopleLocationExclude": ["India", "Brazil"]`
Seniority	`"seniority": "Founder\nC Suite\nVP"`
Excluded seniority	`"seniorityExclude": "Intern\nEntry"`
Years in current role	`"yearsCurrentRole": "1 to 2 years"`
Years in current company	`"yearsCurrentCompany": "3 to 5 years"`
Total work experience	`"yearsWorkExperience": "More than 10 years"`
Skills	`"skills": "lead generation\nsales automation"`
Excluded skills	`"skillsExclude": "customer support"`
Languages	`"language": "English\nFrench"`
Excluded languages	`"languageExclude": "Russian"`
Certifications	`"certification": "HubSpot Sales Software\nSalesforce Administrator"`
Excluded certifications	`"certificationExclude": "Google Ads"`
Profile keywords	`"profileKeywords": "growth\noutbound\nB2B"`
Excluded profile keywords	`"profileKeywordsExclude": "student\nfreelance"`
Profile badges	`"profileBadge": "Open to Work\nCreator"`
Industries	`"industry": "software development\nit services and it consulting"`
Excluded industries	`"industryExclude": "staffing and recruiting"`
Employee size	`"size": "11-50"`
Company HQ locations	`"hq": "Paris, France\nNew York, United States"`
Excluded HQ locations	`"hqExclude": "San Francisco, United States"`
Company type	`"type": "PRIVATELY_HELD\nPUBLIC_COMPANY"`
Excluded company type	`"typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT"`
Revenue	`"revenue": "1000000-10000000"`
Company keywords	`"companyKeywords": "sales automation\nlead enrichment"`
Excluded company keywords	`"companyKeywordsExclude": "agency\nconsulting"`
Founded year	`"founded": "2015-2022"`
Funding rounds	`"funding": "SEED\nSERIES_A"`
Funding amount	`"fundingAmount": "1000000-5000000"`
Funding date	`"fundingDateMonths": "12"`
Department headcount	`"department": "sales\n10-100"`
Department growth	`"growth": "sales\n20-80\n3 months"`

Preset Values

Search Mode

SMART
WORD
STRICT

SMART
WORD
STRICT

SMART
WORD
STRICT

Experience Duration

Applies to yearsCurrentRole, yearsCurrentCompany, and yearsWorkExperience.

Less than 1 year
1 to 2 years
3 to 5 years
6 to 10 years
More than 10 years

Less than 1 year
1 to 2 years
3 to 5 years
6 to 10 years
More than 10 years

Less than 1 year
1 to 2 years
3 to 5 years
6 to 10 years
More than 10 years

Seniority

Head
Senior
Owner
Entry
Manager
Partner
Intern
Director
Founder
VP
C Suite

Head
Senior
Owner
Entry
Manager
Partner
Intern
Director
Founder
VP
C Suite

Head
Senior
Owner
Entry
Manager
Partner
Intern
Director
Founder
VP
C Suite

Profile Badge

Verified Account
Paid Social Members
Open to Work
Influencer
Creator
Hiring (Beta)

Verified Account
Paid Social Members
Open to Work
Influencer
Creator
Hiring (Beta)

Verified Account
Paid Social Members
Open to Work
Influencer
Creator
Hiring (Beta)

Language

English
Chinese
Hindi
Spanish
Arabic
Bengali
Portuguese
Russian
Indonesian
Panjabi
Japanese
German
Javanese
Korean
Vietnamese
Turkish
French
Marathi
Tamil
Urdu
Italian
Thai
Persian
Polish
Telugu

English
Chinese
Hindi
Spanish
Arabic
Bengali
Portuguese
Russian
Indonesian
Panjabi
Japanese
German
Javanese
Korean
Vietnamese
Turkish
French
Marathi
Tamil
Urdu
Italian
Thai
Persian
Polish
Telugu

English
Chinese
Hindi
Spanish
Arabic
Bengali
Portuguese
Russian
Indonesian
Panjabi
Japanese
German
Javanese
Korean
Vietnamese
Turkish
French
Marathi
Tamil
Urdu
Italian
Thai
Persian
Polish
Telugu

Company Size

Company Type

PRIVATELY_HELD
SELF_OWNED
SELF_EMPLOYED
PARTNERSHIP
PUBLIC_COMPANY
NON_PROFIT
EDUCATIONAL
GOVERNMENT_AGENCY

PRIVATELY_HELD
SELF_OWNED
SELF_EMPLOYED
PARTNERSHIP
PUBLIC_COMPANY
NON_PROFIT
EDUCATIONAL
GOVERNMENT_AGENCY

PRIVATELY_HELD
SELF_OWNED
SELF_EMPLOYED
PARTNERSHIP
PUBLIC_COMPANY
NON_PROFIT
EDUCATIONAL
GOVERNMENT_AGENCY

Funding Round

PRE_SEED
SEED
SERIES_A
SERIES_B
SERIES_C
SERIES_D
SERIES_E
SERIES_F
SERIES_G
SERIES_H
SERIES_I
SERIES_J
VENTURE_ROUND
ANGEL
PRIVATE_EQUITY
DEBT_FINANCING
CONVERTIBLE_NOTE
GRANT
CORPORATE_ROUND
EQUITY_CROWDFUNDING
PRODUCT_CROWDFUNDING
SECONDARY_MARKET
POST_IPO_EQUITY
POST_IPO_DEBT
POST_IPO_SECONDARY
NON_EQUITY_ASSISTANCE
INITIAL_COIN_OFFERING
UNDISCLOSED
SERIES_UNKNOWN
FUNDING_ROUND

PRE_SEED
SEED
SERIES_A
SERIES_B
SERIES_C
SERIES_D
SERIES_E
SERIES_F
SERIES_G
SERIES_H
SERIES_I
SERIES_J
VENTURE_ROUND
ANGEL
PRIVATE_EQUITY
DEBT_FINANCING
CONVERTIBLE_NOTE
GRANT
CORPORATE_ROUND
EQUITY_CROWDFUNDING
PRODUCT_CROWDFUNDING
SECONDARY_MARKET
POST_IPO_EQUITY
POST_IPO_DEBT
POST_IPO_SECONDARY
NON_EQUITY_ASSISTANCE
INITIAL_COIN_OFFERING
UNDISCLOSED
SERIES_UNKNOWN
FUNDING_ROUND

PRE_SEED
SEED
SERIES_A
SERIES_B
SERIES_C
SERIES_D
SERIES_E
SERIES_F
SERIES_G
SERIES_H
SERIES_I
SERIES_J
VENTURE_ROUND
ANGEL
PRIVATE_EQUITY
DEBT_FINANCING
CONVERTIBLE_NOTE
GRANT
CORPORATE_ROUND
EQUITY_CROWDFUNDING
PRODUCT_CROWDFUNDING
SECONDARY_MARKET
POST_IPO_EQUITY
POST_IPO_DEBT
POST_IPO_SECONDARY
NON_EQUITY_ASSISTANCE
INITIAL_COIN_OFFERING
UNDISCLOSED
SERIES_UNKNOWN
FUNDING_ROUND

Funding Date

Use one of these values for fundingDateMonths.

Department / Function

program_and_project_management
education
purchasing
accounting
sales
research
operations
customer_success_and_support
legal
product_management
media_and_communication
real_estate
quality_assurance
consulting
arts_and_design
healthcare_services
entrepreneurship
engineering
community_and_snology
business_development
administrative
military_and_protective_services
finance
human_resources
support

program_and_project_management
education
purchasing
accounting
sales
research
operations
customer_success_and_support
legal
product_management
media_and_communication
real_estate
quality_assurance
consulting
arts_and_design
healthcare_services
entrepreneurship
engineering
community_and_snology
business_development
administrative
military_and_protective_services
finance
human_resources
support

program_and_project_management
education
purchasing
accounting
sales
research
operations
customer_success_and_support
legal
product_management
media_and_communication
real_estate
quality_assurance
consulting
arts_and_design
healthcare_services
entrepreneurship
engineering
community_and_snology
business_development
administrative
military_and_protective_services
finance
human_resources
support

Growth Timeframe

Use one of these month values inside growth.

Industry

These are the first Lead Finder industry presets. The API also accepts custom text values.

real estate
medical practices
construction
retail
software development
business consulting and services
it services and it consulting
individual and family services
restaurants
advertising services
hospitals and health care
wholesale
civic and social organizations
financial services
wellness and fitness services
hospitality
non-profit organizations
truck transportation
facilities services
manufacturing
appliances, electrical, and electronics manufacturing
consumer services
food and beverage services
machinery manufacturing
higher education
technology, information and internet
spectator sports
motor vehicle manufacturing
architecture and planning
farming
food and beverage manufacturing
accounting
mining
retail apparel and fashion
design services
education administration programs
industrial machinery manufacturing
insurance
professional training and coaching
performing arts
travel arrangements
law practice
legal services
retail office equipment
research services
entertainment providers
government administration
book and periodical publishing
e-learning providers
events services
religious institutions
media production
environmental services
human resources services
staffing and recruiting
wholesale building materials
civil engineering
furniture and home furnishings manufacturing
recreational facilities
investment management
telecommunications
photography
freight and package transportation
utilities
primary and secondary education
textile manufacturing
oil and gas
retail groceries
medical equipment manufacturing
chemical manufacturing
musicians
paper and forest product manufacturing
personal care product manufacturing
plastics manufacturing
veterinary services
graphic design
movies, videos, and sound
broadcast media production and distribution
information services
online audio and video media
security and investigations
renewable energy semiconductor manufacturing
ranching
printing services
public relations and communications services
banking
international trade and development
mental health care
transportation, logistics, supply chain and storage
computers and electronics manufacturing
retail luxury goods and jewelry
pharmaceutical manufacturing
artists and writers
biotechnology research
museums, historical sites, and zoos
investment banking
retail art supplies
writing and editing
airlines and aviation
automation machinery manufacturing
beverage manufacturing
executive offices
computer games
glass, ceramics and concrete manufacturing
venture capital and private equity principals
computer and network security
outsourcing and offshoring consulting
leasing non-residential real estate
packaging and containers manufacturing
wholesale import and export
defense and space manufacturing
market research
semiconductor manufacturing
dairy product manufacturing
maritime transportation
aviation and aerospace component manufacturing
computer hardware manufacturing
warehousing and storage
translation and localization
newspaper publishing
sporting goods manufacturing
capital markets
public safety
alternative medicine
fisheries
political organizations
shipbuilding
think tanks
animation and post-production
law enforcement
computer networking products
philanthropic fundraising services
strategic management services
government relations services
fundraising
tobacco manufacturing
gambling facilities and casinos
international affairs
libraries
administration of justice
railroad equipment manufacturing
armed forces
wireless services
public policy offices
alternative dispute resolution
nanotechnology research
legislative offices
mobile gaming apps

real estate
medical practices
construction
retail
software development
business consulting and services
it services and it consulting
individual and family services
restaurants
advertising services
hospitals and health care
wholesale
civic and social organizations
financial services
wellness and fitness services
hospitality
non-profit organizations
truck transportation
facilities services
manufacturing
appliances, electrical, and electronics manufacturing
consumer services
food and beverage services
machinery manufacturing
higher education
technology, information and internet
spectator sports
motor vehicle manufacturing
architecture and planning
farming
food and beverage manufacturing
accounting
mining
retail apparel and fashion
design services
education administration programs
industrial machinery manufacturing
insurance
professional training and coaching
performing arts
travel arrangements
law practice
legal services
retail office equipment
research services
entertainment providers
government administration
book and periodical publishing
e-learning providers
events services
religious institutions
media production
environmental services
human resources services
staffing and recruiting
wholesale building materials
civil engineering
furniture and home furnishings manufacturing
recreational facilities
investment management
telecommunications
photography
freight and package transportation
utilities
primary and secondary education
textile manufacturing
oil and gas
retail groceries
medical equipment manufacturing
chemical manufacturing
musicians
paper and forest product manufacturing
personal care product manufacturing
plastics manufacturing
veterinary services
graphic design
movies, videos, and sound
broadcast media production and distribution
information services
online audio and video media
security and investigations
renewable energy semiconductor manufacturing
ranching
printing services
public relations and communications services
banking
international trade and development
mental health care
transportation, logistics, supply chain and storage
computers and electronics manufacturing
retail luxury goods and jewelry
pharmaceutical manufacturing
artists and writers
biotechnology research
museums, historical sites, and zoos
investment banking
retail art supplies
writing and editing
airlines and aviation
automation machinery manufacturing
beverage manufacturing
executive offices
computer games
glass, ceramics and concrete manufacturing
venture capital and private equity principals
computer and network security
outsourcing and offshoring consulting
leasing non-residential real estate
packaging and containers manufacturing
wholesale import and export
defense and space manufacturing
market research
semiconductor manufacturing
dairy product manufacturing
maritime transportation
aviation and aerospace component manufacturing
computer hardware manufacturing
warehousing and storage
translation and localization
newspaper publishing
sporting goods manufacturing
capital markets
public safety
alternative medicine
fisheries
political organizations
shipbuilding
think tanks
animation and post-production
law enforcement
computer networking products
philanthropic fundraising services
strategic management services
government relations services
fundraising
tobacco manufacturing
gambling facilities and casinos
international affairs
libraries
administration of justice
railroad equipment manufacturing
armed forces
wireless services
public policy offices
alternative dispute resolution
nanotechnology research
legislative offices
mobile gaming apps

real estate
medical practices
construction
retail
software development
business consulting and services
it services and it consulting
individual and family services
restaurants
advertising services
hospitals and health care
wholesale
civic and social organizations
financial services
wellness and fitness services
hospitality
non-profit organizations
truck transportation
facilities services
manufacturing
appliances, electrical, and electronics manufacturing
consumer services
food and beverage services
machinery manufacturing
higher education
technology, information and internet
spectator sports
motor vehicle manufacturing
architecture and planning
farming
food and beverage manufacturing
accounting
mining
retail apparel and fashion
design services
education administration programs
industrial machinery manufacturing
insurance
professional training and coaching
performing arts
travel arrangements
law practice
legal services
retail office equipment
research services
entertainment providers
government administration
book and periodical publishing
e-learning providers
events services
religious institutions
media production
environmental services
human resources services
staffing and recruiting
wholesale building materials
civil engineering
furniture and home furnishings manufacturing
recreational facilities
investment management
telecommunications
photography
freight and package transportation
utilities
primary and secondary education
textile manufacturing
oil and gas
retail groceries
medical equipment manufacturing
chemical manufacturing
musicians
paper and forest product manufacturing
personal care product manufacturing
plastics manufacturing
veterinary services
graphic design
movies, videos, and sound
broadcast media production and distribution
information services
online audio and video media
security and investigations
renewable energy semiconductor manufacturing
ranching
printing services
public relations and communications services
banking
international trade and development
mental health care
transportation, logistics, supply chain and storage
computers and electronics manufacturing
retail luxury goods and jewelry
pharmaceutical manufacturing
artists and writers
biotechnology research
museums, historical sites, and zoos
investment banking
retail art supplies
writing and editing
airlines and aviation
automation machinery manufacturing
beverage manufacturing
executive offices
computer games
glass, ceramics and concrete manufacturing
venture capital and private equity principals
computer and network security
outsourcing and offshoring consulting
leasing non-residential real estate
packaging and containers manufacturing
wholesale import and export
defense and space manufacturing
market research
semiconductor manufacturing
dairy product manufacturing
maritime transportation
aviation and aerospace component manufacturing
computer hardware manufacturing
warehousing and storage
translation and localization
newspaper publishing
sporting goods manufacturing
capital markets
public safety
alternative medicine
fisheries
political organizations
shipbuilding
think tanks
animation and post-production
law enforcement
computer networking products
philanthropic fundraising services
strategic management services
government relations services
fundraising
tobacco manufacturing
gambling facilities and casinos
international affairs
libraries
administration of justice
railroad equipment manufacturing
armed forces
wireless services
public policy offices
alternative dispute resolution
nanotechnology research
legislative offices
mobile gaming apps

Response

Each row is the full lead record after sanitization. Returned fields can vary by lead depending on the data available. The API removes ID-like fields such as id, _id, uuid, contactId, *_id, *Id, *Urn, and *Identifier recursively, along with internal trace fields. The response does not include provider names, provider trace fields, rawRequest, or rawResponse.

Successful Response (200)

{
  "rows": [
    {
      "firstName": "Victor",
      "lastName": "Detraz",
      "title": "Founder",
      "headline": "Founder at Airscale",
      "skills": ["lead generation", "sales automation"],
      "profile": {
        "linkedin": "https://linkedin.com/in/vdetraz",
        "summary": "Building Airscale"
      },
      "account": {
        "name": "Airscale",
        "link": {
          "website": "https://airscale.io",
          "linkedin": "https://linkedin.com/company/airscale-io"
        },
        "summary": {
          "logo": {
            "source": "https://cdn.example.com/logo.png"
          }
        },
        "industry": ["software development"],
        "employeeCount": 12
      },
      "location": {
        "full": "Paris, France",
        "city": "Paris",
        "country": "France"
      },
      "positionGroups": {
        "contents": [
          {
            "profilePositions": [
              {
                "title": "Founder",
                "companyName": "Airscale",
                "startedOn": {
                  "year": 2023
                }
              }
            ]
          }
        ]
      },
      "linkedinUrl": "https://linkedin.com/in/vdetraz"
    }
  ],
  "total": 1,
  "page": 0,
  "size": 25
}

{
  "rows": [
    {
      "firstName": "Victor",
      "lastName": "Detraz",
      "title": "Founder",
      "headline": "Founder at Airscale",
      "skills": ["lead generation", "sales automation"],
      "profile": {
        "linkedin": "https://linkedin.com/in/vdetraz",
        "summary": "Building Airscale"
      },
      "account": {
        "name": "Airscale",
        "link": {
          "website": "https://airscale.io",
          "linkedin": "https://linkedin.com/company/airscale-io"
        },
        "summary": {
          "logo": {
            "source": "https://cdn.example.com/logo.png"
          }
        },
        "industry": ["software development"],
        "employeeCount": 12
      },
      "location": {
        "full": "Paris, France",
        "city": "Paris",
        "country": "France"
      },
      "positionGroups": {
        "contents": [
          {
            "profilePositions": [
              {
                "title": "Founder",
                "companyName": "Airscale",
                "startedOn": {
                  "year": 2023
                }
              }
            ]
          }
        ]
      },
      "linkedinUrl": "https://linkedin.com/in/vdetraz"
    }
  ],
  "total": 1,
  "page": 0,
  "size": 25
}

{
  "rows": [
    {
      "firstName": "Victor",
      "lastName": "Detraz",
      "title": "Founder",
      "headline": "Founder at Airscale",
      "skills": ["lead generation", "sales automation"],
      "profile": {
        "linkedin": "https://linkedin.com/in/vdetraz",
        "summary": "Building Airscale"
      },
      "account": {
        "name": "Airscale",
        "link": {
          "website": "https://airscale.io",
          "linkedin": "https://linkedin.com/company/airscale-io"
        },
        "summary": {
          "logo": {
            "source": "https://cdn.example.com/logo.png"
          }
        },
        "industry": ["software development"],
        "employeeCount": 12
      },
      "location": {
        "full": "Paris, France",
        "city": "Paris",
        "country": "France"
      },
      "positionGroups": {
        "contents": [
          {
            "profilePositions": [
              {
                "title": "Founder",
                "companyName": "Airscale",
                "startedOn": {
                  "year": 2023
                }
              }
            ]
          }
        ]
      },
      "linkedinUrl": "https://linkedin.com/in/vdetraz"
    }
  ],
  "total": 1,
  "page": 0,
  "size": 25
}

Error Responses

Missing Authorization (401)

{
  "error": "Missing bearer token"
}

{
  "error": "Missing bearer token"
}

{
  "error": "Missing bearer token"
}

Invalid API Key (401)

{
  "error": "Invalid API key"
}

{
  "error": "Invalid API key"
}

{
  "error": "Invalid API key"
}

Invalid Request (400)

{
  "error": "Invalid Leads Finder request",
  "message": "size must be an integer from 1 to 100"
}

{
  "error": "Invalid Leads Finder request",
  "message": "size must be an integer from 1 to 100"
}

{
  "error": "Invalid Leads Finder request",
  "message": "size must be an integer from 1 to 100"
}

Insufficient Credits (403)

{
  "error": "Forbidden",
  "message": "Insufficient credits"
}

{
  "error": "Forbidden",
  "message": "Insufficient credits"
}

{
  "error": "Forbidden",
  "message": "Insufficient credits"
}

Rate Limited (429)

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded: 2 req/sec"
}

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded: 2 req/sec"
}

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded: 2 req/sec"
}

Provider Failure (502)

{
  "error": "Lead Finder people search failed",
  "status": 500
}

{
  "error": "Lead Finder people search failed",
  "status": 500
}

{
  "error": "Lead Finder people search failed",
  "status": 500
}

Example Usage

The examples below use the complete all-filter payload. Remove any filter keys you do not need.

cURL

curl -X POST https://api.airscale.io/v1/leads-finder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "job": ["Founder", "CEO", "VP Sales"],
      "jobExclude": ["Intern", "Assistant"],
      "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
      "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
      "peopleLocation": ["France", "Paris, France", "United States"],
      "peopleLocationExclude": ["India", "Brazil"],
      "seniority": "Founder\nC Suite\nVP\nDirector",
      "seniorityExclude": "Intern\nEntry",
      "yearsCurrentRole": "1 to 2 years",
      "yearsCurrentCompany": "3 to 5 years",
      "yearsWorkExperience": "More than 10 years",
      "skills": "lead generation\nsales automation\nprospecting",
      "skillsExclude": "customer support",
      "language": "English\nFrench",
      "languageExclude": "Russian",
      "certification": "HubSpot Sales Software\nSalesforce Administrator",
      "certificationExclude": "Google Ads",
      "profileKeywords": "growth\noutbound\nB2B",
      "profileKeywordsExclude": "student\nfreelance",
      "profileBadge": "Open to Work\nCreator",
      "industry": "software development\nit services and it consulting",
      "industryExclude": "staffing and recruiting",
      "size": "11-50",
      "hq": "Paris, France\nNew York, United States",
      "hqExclude": "San Francisco, United States",
      "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
      "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
      "revenue": "1000000-10000000",
      "companyKeywords": "sales automation\nlead enrichment",
      "companyKeywordsExclude": "agency\nconsulting",
      "founded": "2015-2022",
      "funding": "SEED\nSERIES_A",
      "fundingAmount": "1000000-5000000",
      "fundingDateMonths": "12",
      "department": "sales\n10-100",
      "growth": "sales\n20-80\n3 months",
      "searchMode": "SMART"
    },
    "page": 0,
    "size": 25
  }'

curl -X POST https://api.airscale.io/v1/leads-finder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "job": ["Founder", "CEO", "VP Sales"],
      "jobExclude": ["Intern", "Assistant"],
      "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
      "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
      "peopleLocation": ["France", "Paris, France", "United States"],
      "peopleLocationExclude": ["India", "Brazil"],
      "seniority": "Founder\nC Suite\nVP\nDirector",
      "seniorityExclude": "Intern\nEntry",
      "yearsCurrentRole": "1 to 2 years",
      "yearsCurrentCompany": "3 to 5 years",
      "yearsWorkExperience": "More than 10 years",
      "skills": "lead generation\nsales automation\nprospecting",
      "skillsExclude": "customer support",
      "language": "English\nFrench",
      "languageExclude": "Russian",
      "certification": "HubSpot Sales Software\nSalesforce Administrator",
      "certificationExclude": "Google Ads",
      "profileKeywords": "growth\noutbound\nB2B",
      "profileKeywordsExclude": "student\nfreelance",
      "profileBadge": "Open to Work\nCreator",
      "industry": "software development\nit services and it consulting",
      "industryExclude": "staffing and recruiting",
      "size": "11-50",
      "hq": "Paris, France\nNew York, United States",
      "hqExclude": "San Francisco, United States",
      "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
      "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
      "revenue": "1000000-10000000",
      "companyKeywords": "sales automation\nlead enrichment",
      "companyKeywordsExclude": "agency\nconsulting",
      "founded": "2015-2022",
      "funding": "SEED\nSERIES_A",
      "fundingAmount": "1000000-5000000",
      "fundingDateMonths": "12",
      "department": "sales\n10-100",
      "growth": "sales\n20-80\n3 months",
      "searchMode": "SMART"
    },
    "page": 0,
    "size": 25
  }'

curl -X POST https://api.airscale.io/v1/leads-finder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "job": ["Founder", "CEO", "VP Sales"],
      "jobExclude": ["Intern", "Assistant"],
      "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
      "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
      "peopleLocation": ["France", "Paris, France", "United States"],
      "peopleLocationExclude": ["India", "Brazil"],
      "seniority": "Founder\nC Suite\nVP\nDirector",
      "seniorityExclude": "Intern\nEntry",
      "yearsCurrentRole": "1 to 2 years",
      "yearsCurrentCompany": "3 to 5 years",
      "yearsWorkExperience": "More than 10 years",
      "skills": "lead generation\nsales automation\nprospecting",
      "skillsExclude": "customer support",
      "language": "English\nFrench",
      "languageExclude": "Russian",
      "certification": "HubSpot Sales Software\nSalesforce Administrator",
      "certificationExclude": "Google Ads",
      "profileKeywords": "growth\noutbound\nB2B",
      "profileKeywordsExclude": "student\nfreelance",
      "profileBadge": "Open to Work\nCreator",
      "industry": "software development\nit services and it consulting",
      "industryExclude": "staffing and recruiting",
      "size": "11-50",
      "hq": "Paris, France\nNew York, United States",
      "hqExclude": "San Francisco, United States",
      "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
      "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
      "revenue": "1000000-10000000",
      "companyKeywords": "sales automation\nlead enrichment",
      "companyKeywordsExclude": "agency\nconsulting",
      "founded": "2015-2022",
      "funding": "SEED\nSERIES_A",
      "fundingAmount": "1000000-5000000",
      "fundingDateMonths": "12",
      "department": "sales\n10-100",
      "growth": "sales\n20-80\n3 months",
      "searchMode": "SMART"
    },
    "page": 0,
    "size": 25
  }'

Python

import requests

url = "https://api.airscale.io/v1/leads-finder"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "filters": {
        "job": ["Founder", "CEO", "VP Sales"],
        "jobExclude": ["Intern", "Assistant"],
        "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
        "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
        "peopleLocation": ["France", "Paris, France", "United States"],
        "peopleLocationExclude": ["India", "Brazil"],
        "seniority": "Founder\nC Suite\nVP\nDirector",
        "seniorityExclude": "Intern\nEntry",
        "yearsCurrentRole": "1 to 2 years",
        "yearsCurrentCompany": "3 to 5 years",
        "yearsWorkExperience": "More than 10 years",
        "skills": "lead generation\nsales automation\nprospecting",
        "skillsExclude": "customer support",
        "language": "English\nFrench",
        "languageExclude": "Russian",
        "certification": "HubSpot Sales Software\nSalesforce Administrator",
        "certificationExclude": "Google Ads",
        "profileKeywords": "growth\noutbound\nB2B",
        "profileKeywordsExclude": "student\nfreelance",
        "profileBadge": "Open to Work\nCreator",
        "industry": "software development\nit services and it consulting",
        "industryExclude": "staffing and recruiting",
        "size": "11-50",
        "hq": "Paris, France\nNew York, United States",
        "hqExclude": "San Francisco, United States",
        "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
        "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
        "revenue": "1000000-10000000",
        "companyKeywords": "sales automation\nlead enrichment",
        "companyKeywordsExclude": "agency\nconsulting",
        "founded": "2015-2022",
        "funding": "SEED\nSERIES_A",
        "fundingAmount": "1000000-5000000",
        "fundingDateMonths": "12",
        "department": "sales\n10-100",
        "growth": "sales\n20-80\n3 months",
        "searchMode": "SMART",
    },
    "page": 0,
    "size": 25,
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

import requests

url = "https://api.airscale.io/v1/leads-finder"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "filters": {
        "job": ["Founder", "CEO", "VP Sales"],
        "jobExclude": ["Intern", "Assistant"],
        "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
        "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
        "peopleLocation": ["France", "Paris, France", "United States"],
        "peopleLocationExclude": ["India", "Brazil"],
        "seniority": "Founder\nC Suite\nVP\nDirector",
        "seniorityExclude": "Intern\nEntry",
        "yearsCurrentRole": "1 to 2 years",
        "yearsCurrentCompany": "3 to 5 years",
        "yearsWorkExperience": "More than 10 years",
        "skills": "lead generation\nsales automation\nprospecting",
        "skillsExclude": "customer support",
        "language": "English\nFrench",
        "languageExclude": "Russian",
        "certification": "HubSpot Sales Software\nSalesforce Administrator",
        "certificationExclude": "Google Ads",
        "profileKeywords": "growth\noutbound\nB2B",
        "profileKeywordsExclude": "student\nfreelance",
        "profileBadge": "Open to Work\nCreator",
        "industry": "software development\nit services and it consulting",
        "industryExclude": "staffing and recruiting",
        "size": "11-50",
        "hq": "Paris, France\nNew York, United States",
        "hqExclude": "San Francisco, United States",
        "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
        "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
        "revenue": "1000000-10000000",
        "companyKeywords": "sales automation\nlead enrichment",
        "companyKeywordsExclude": "agency\nconsulting",
        "founded": "2015-2022",
        "funding": "SEED\nSERIES_A",
        "fundingAmount": "1000000-5000000",
        "fundingDateMonths": "12",
        "department": "sales\n10-100",
        "growth": "sales\n20-80\n3 months",
        "searchMode": "SMART",
    },
    "page": 0,
    "size": 25,
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

import requests

url = "https://api.airscale.io/v1/leads-finder"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "filters": {
        "job": ["Founder", "CEO", "VP Sales"],
        "jobExclude": ["Intern", "Assistant"],
        "company": ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
        "companyUrl": ["airscale.io", "https://www.linkedin.com/company/openai"],
        "peopleLocation": ["France", "Paris, France", "United States"],
        "peopleLocationExclude": ["India", "Brazil"],
        "seniority": "Founder\nC Suite\nVP\nDirector",
        "seniorityExclude": "Intern\nEntry",
        "yearsCurrentRole": "1 to 2 years",
        "yearsCurrentCompany": "3 to 5 years",
        "yearsWorkExperience": "More than 10 years",
        "skills": "lead generation\nsales automation\nprospecting",
        "skillsExclude": "customer support",
        "language": "English\nFrench",
        "languageExclude": "Russian",
        "certification": "HubSpot Sales Software\nSalesforce Administrator",
        "certificationExclude": "Google Ads",
        "profileKeywords": "growth\noutbound\nB2B",
        "profileKeywordsExclude": "student\nfreelance",
        "profileBadge": "Open to Work\nCreator",
        "industry": "software development\nit services and it consulting",
        "industryExclude": "staffing and recruiting",
        "size": "11-50",
        "hq": "Paris, France\nNew York, United States",
        "hqExclude": "San Francisco, United States",
        "type": "PRIVATELY_HELD\nPUBLIC_COMPANY",
        "typeExclude": "GOVERNMENT_AGENCY\nNON_PROFIT",
        "revenue": "1000000-10000000",
        "companyKeywords": "sales automation\nlead enrichment",
        "companyKeywordsExclude": "agency\nconsulting",
        "founded": "2015-2022",
        "funding": "SEED\nSERIES_A",
        "fundingAmount": "1000000-5000000",
        "fundingDateMonths": "12",
        "department": "sales\n10-100",
        "growth": "sales\n20-80\n3 months",
        "searchMode": "SMART",
    },
    "page": 0,
    "size": 25,
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

JavaScript (Fetch)

const url = "https://api.airscale.io/v1/leads-finder";
const headers = {
  Authorization: "Bearer YOUR_API_KEY",
  "Content-Type": "application/json",
};
const payload = {
  filters: {
    job: ["Founder", "CEO", "VP Sales"],
    jobExclude: ["Intern", "Assistant"],
    company: ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
    companyUrl: ["airscale.io", "https://www.linkedin.com/company/openai"],
    peopleLocation: ["France", "Paris, France", "United States"],
    peopleLocationExclude: ["India", "Brazil"],
    seniority: "Founder\nC Suite\nVP\nDirector",
    seniorityExclude: "Intern\nEntry",
    yearsCurrentRole: "1 to 2 years",
    yearsCurrentCompany: "3 to 5 years",
    yearsWorkExperience: "More than 10 years",
    skills: "lead generation\nsales automation\nprospecting",
    skillsExclude: "customer support",
    language: "English\nFrench",
    languageExclude: "Russian",
    certification: "HubSpot Sales Software\nSalesforce Administrator",
    certificationExclude: "Google Ads",
    profileKeywords: "growth\noutbound\nB2B",
    profileKeywordsExclude: "student\nfreelance",
    profileBadge: "Open to Work\nCreator",
    industry: "software development\nit services and it consulting",
    industryExclude: "staffing and recruiting",
    size: "11-50",
    hq: "Paris, France\nNew York, United States",
    hqExclude: "San Francisco, United States",
    type: "PRIVATELY_HELD\nPUBLIC_COMPANY",
    typeExclude: "GOVERNMENT_AGENCY\nNON_PROFIT",
    revenue: "1000000-10000000",
    companyKeywords: "sales automation\nlead enrichment",
    companyKeywordsExclude: "agency\nconsulting",
    founded: "2015-2022",
    funding: "SEED\nSERIES_A",
    fundingAmount: "1000000-5000000",
    fundingDateMonths: "12",
    department: "sales\n10-100",
    growth: "sales\n20-80\n3 months",
    searchMode: "SMART",
  },
  page: 0,
  size: 25,
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

const url = "https://api.airscale.io/v1/leads-finder";
const headers = {
  Authorization: "Bearer YOUR_API_KEY",
  "Content-Type": "application/json",
};
const payload = {
  filters: {
    job: ["Founder", "CEO", "VP Sales"],
    jobExclude: ["Intern", "Assistant"],
    company: ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
    companyUrl: ["airscale.io", "https://www.linkedin.com/company/openai"],
    peopleLocation: ["France", "Paris, France", "United States"],
    peopleLocationExclude: ["India", "Brazil"],
    seniority: "Founder\nC Suite\nVP\nDirector",
    seniorityExclude: "Intern\nEntry",
    yearsCurrentRole: "1 to 2 years",
    yearsCurrentCompany: "3 to 5 years",
    yearsWorkExperience: "More than 10 years",
    skills: "lead generation\nsales automation\nprospecting",
    skillsExclude: "customer support",
    language: "English\nFrench",
    languageExclude: "Russian",
    certification: "HubSpot Sales Software\nSalesforce Administrator",
    certificationExclude: "Google Ads",
    profileKeywords: "growth\noutbound\nB2B",
    profileKeywordsExclude: "student\nfreelance",
    profileBadge: "Open to Work\nCreator",
    industry: "software development\nit services and it consulting",
    industryExclude: "staffing and recruiting",
    size: "11-50",
    hq: "Paris, France\nNew York, United States",
    hqExclude: "San Francisco, United States",
    type: "PRIVATELY_HELD\nPUBLIC_COMPANY",
    typeExclude: "GOVERNMENT_AGENCY\nNON_PROFIT",
    revenue: "1000000-10000000",
    companyKeywords: "sales automation\nlead enrichment",
    companyKeywordsExclude: "agency\nconsulting",
    founded: "2015-2022",
    funding: "SEED\nSERIES_A",
    fundingAmount: "1000000-5000000",
    fundingDateMonths: "12",
    department: "sales\n10-100",
    growth: "sales\n20-80\n3 months",
    searchMode: "SMART",
  },
  page: 0,
  size: 25,
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

const url = "https://api.airscale.io/v1/leads-finder";
const headers = {
  Authorization: "Bearer YOUR_API_KEY",
  "Content-Type": "application/json",
};
const payload = {
  filters: {
    job: ["Founder", "CEO", "VP Sales"],
    jobExclude: ["Intern", "Assistant"],
    company: ["airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"],
    companyUrl: ["airscale.io", "https://www.linkedin.com/company/openai"],
    peopleLocation: ["France", "Paris, France", "United States"],
    peopleLocationExclude: ["India", "Brazil"],
    seniority: "Founder\nC Suite\nVP\nDirector",
    seniorityExclude: "Intern\nEntry",
    yearsCurrentRole: "1 to 2 years",
    yearsCurrentCompany: "3 to 5 years",
    yearsWorkExperience: "More than 10 years",
    skills: "lead generation\nsales automation\nprospecting",
    skillsExclude: "customer support",
    language: "English\nFrench",
    languageExclude: "Russian",
    certification: "HubSpot Sales Software\nSalesforce Administrator",
    certificationExclude: "Google Ads",
    profileKeywords: "growth\noutbound\nB2B",
    profileKeywordsExclude: "student\nfreelance",
    profileBadge: "Open to Work\nCreator",
    industry: "software development\nit services and it consulting",
    industryExclude: "staffing and recruiting",
    size: "11-50",
    hq: "Paris, France\nNew York, United States",
    hqExclude: "San Francisco, United States",
    type: "PRIVATELY_HELD\nPUBLIC_COMPANY",
    typeExclude: "GOVERNMENT_AGENCY\nNON_PROFIT",
    revenue: "1000000-10000000",
    companyKeywords: "sales automation\nlead enrichment",
    companyKeywordsExclude: "agency\nconsulting",
    founded: "2015-2022",
    funding: "SEED\nSERIES_A",
    fundingAmount: "1000000-5000000",
    fundingDateMonths: "12",
    department: "sales\n10-100",
    growth: "sales\n20-80\n3 months",
    searchMode: "SMART",
  },
  page: 0,
  size: 25,
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));

PHP

<?php

$url = 'https://api.airscale.io/v1/leads-finder';
$headers = [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
];
$payload = json_encode([
    'filters' => [
        'job' => ['Founder', 'CEO', 'VP Sales'],
        'jobExclude' => ['Intern', 'Assistant'],
        'company' => ['airscale.io', 'OpenAI', 'https://www.linkedin.com/company/airscale-io'],
        'companyUrl' => ['airscale.io', 'https://www.linkedin.com/company/openai'],
        'peopleLocation' => ['France', 'Paris, France', 'United States'],
        'peopleLocationExclude' => ['India', 'Brazil'],
        'seniority' => "Founder\nC Suite\nVP\nDirector",
        'seniorityExclude' => "Intern\nEntry",
        'yearsCurrentRole' => '1 to 2 years',
        'yearsCurrentCompany' => '3 to 5 years',
        'yearsWorkExperience' => 'More than 10 years',
        'skills' => "lead generation\nsales automation\nprospecting",
        'skillsExclude' => 'customer support',
        'language' => "English\nFrench",
        'languageExclude' => 'Russian',
        'certification' => "HubSpot Sales Software\nSalesforce Administrator",
        'certificationExclude' => 'Google Ads',
        'profileKeywords' => "growth\noutbound\nB2B",
        'profileKeywordsExclude' => "student\nfreelance",
        'profileBadge' => "Open to Work\nCreator",
        'industry' => "software development\nit services and it consulting",
        'industryExclude' => 'staffing and recruiting',
        'size' => '11-50',
        'hq' => "Paris, France\nNew York, United States",
        'hqExclude' => 'San Francisco, United States',
        'type' => "PRIVATELY_HELD\nPUBLIC_COMPANY",
        'typeExclude' => "GOVERNMENT_AGENCY\nNON_PROFIT",
        'revenue' => '1000000-10000000',
        'companyKeywords' => "sales automation\nlead enrichment",
        'companyKeywordsExclude' => "agency\nconsulting",
        'founded' => '2015-2022',
        'funding' => "SEED\nSERIES_A",
        'fundingAmount' => '1000000-5000000',
        'fundingDateMonths' => '12',
        'department' => "sales\n10-100",
        'growth' => "sales\n20-80\n3 months",
        'searchMode' => 'SMART'
    ],
    'page' => 0,
    'size' => 25
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

<?php

$url = 'https://api.airscale.io/v1/leads-finder';
$headers = [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
];
$payload = json_encode([
    'filters' => [
        'job' => ['Founder', 'CEO', 'VP Sales'],
        'jobExclude' => ['Intern', 'Assistant'],
        'company' => ['airscale.io', 'OpenAI', 'https://www.linkedin.com/company/airscale-io'],
        'companyUrl' => ['airscale.io', 'https://www.linkedin.com/company/openai'],
        'peopleLocation' => ['France', 'Paris, France', 'United States'],
        'peopleLocationExclude' => ['India', 'Brazil'],
        'seniority' => "Founder\nC Suite\nVP\nDirector",
        'seniorityExclude' => "Intern\nEntry",
        'yearsCurrentRole' => '1 to 2 years',
        'yearsCurrentCompany' => '3 to 5 years',
        'yearsWorkExperience' => 'More than 10 years',
        'skills' => "lead generation\nsales automation\nprospecting",
        'skillsExclude' => 'customer support',
        'language' => "English\nFrench",
        'languageExclude' => 'Russian',
        'certification' => "HubSpot Sales Software\nSalesforce Administrator",
        'certificationExclude' => 'Google Ads',
        'profileKeywords' => "growth\noutbound\nB2B",
        'profileKeywordsExclude' => "student\nfreelance",
        'profileBadge' => "Open to Work\nCreator",
        'industry' => "software development\nit services and it consulting",
        'industryExclude' => 'staffing and recruiting',
        'size' => '11-50',
        'hq' => "Paris, France\nNew York, United States",
        'hqExclude' => 'San Francisco, United States',
        'type' => "PRIVATELY_HELD\nPUBLIC_COMPANY",
        'typeExclude' => "GOVERNMENT_AGENCY\nNON_PROFIT",
        'revenue' => '1000000-10000000',
        'companyKeywords' => "sales automation\nlead enrichment",
        'companyKeywordsExclude' => "agency\nconsulting",
        'founded' => '2015-2022',
        'funding' => "SEED\nSERIES_A",
        'fundingAmount' => '1000000-5000000',
        'fundingDateMonths' => '12',
        'department' => "sales\n10-100",
        'growth' => "sales\n20-80\n3 months",
        'searchMode' => 'SMART'
    ],
    'page' => 0,
    'size' => 25
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

<?php

$url = 'https://api.airscale.io/v1/leads-finder';
$headers = [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
];
$payload = json_encode([
    'filters' => [
        'job' => ['Founder', 'CEO', 'VP Sales'],
        'jobExclude' => ['Intern', 'Assistant'],
        'company' => ['airscale.io', 'OpenAI', 'https://www.linkedin.com/company/airscale-io'],
        'companyUrl' => ['airscale.io', 'https://www.linkedin.com/company/openai'],
        'peopleLocation' => ['France', 'Paris, France', 'United States'],
        'peopleLocationExclude' => ['India', 'Brazil'],
        'seniority' => "Founder\nC Suite\nVP\nDirector",
        'seniorityExclude' => "Intern\nEntry",
        'yearsCurrentRole' => '1 to 2 years',
        'yearsCurrentCompany' => '3 to 5 years',
        'yearsWorkExperience' => 'More than 10 years',
        'skills' => "lead generation\nsales automation\nprospecting",
        'skillsExclude' => 'customer support',
        'language' => "English\nFrench",
        'languageExclude' => 'Russian',
        'certification' => "HubSpot Sales Software\nSalesforce Administrator",
        'certificationExclude' => 'Google Ads',
        'profileKeywords' => "growth\noutbound\nB2B",
        'profileKeywordsExclude' => "student\nfreelance",
        'profileBadge' => "Open to Work\nCreator",
        'industry' => "software development\nit services and it consulting",
        'industryExclude' => 'staffing and recruiting',
        'size' => '11-50',
        'hq' => "Paris, France\nNew York, United States",
        'hqExclude' => 'San Francisco, United States',
        'type' => "PRIVATELY_HELD\nPUBLIC_COMPANY",
        'typeExclude' => "GOVERNMENT_AGENCY\nNON_PROFIT",
        'revenue' => '1000000-10000000',
        'companyKeywords' => "sales automation\nlead enrichment",
        'companyKeywordsExclude' => "agency\nconsulting",
        'founded' => '2015-2022',
        'funding' => "SEED\nSERIES_A",
        'fundingAmount' => '1000000-5000000',
        'fundingDateMonths' => '12',
        'department' => "sales\n10-100",
        'growth' => "sales\n20-80\n3 months",
        'searchMode' => 'SMART'
    ],
    'page' => 0,
    'size' => 25
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://api.airscale.io/v1/leads-finder"

    payload := map[string]interface{}{
        "filters": map[string]interface{}{
            "job":                    []string{"Founder", "CEO", "VP Sales"},
            "jobExclude":             []string{"Intern", "Assistant"},
            "company":                []string{"airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"},
            "companyUrl":             []string{"airscale.io", "https://www.linkedin.com/company/openai"},
            "peopleLocation":         []string{"France", "Paris, France", "United States"},
            "peopleLocationExclude":  []string{"India", "Brazil"},
            "seniority":              "Founder\nC Suite\nVP\nDirector",
            "seniorityExclude":       "Intern\nEntry",
            "yearsCurrentRole":       "1 to 2 years",
            "yearsCurrentCompany":    "3 to 5 years",
            "yearsWorkExperience":    "More than 10 years",
            "skills":                 "lead generation\nsales automation\nprospecting",
            "skillsExclude":          "customer support",
            "language":               "English\nFrench",
            "languageExclude":        "Russian",
            "certification":          "HubSpot Sales Software\nSalesforce Administrator",
            "certificationExclude":   "Google Ads",
            "profileKeywords":        "growth\noutbound\nB2B",
            "profileKeywordsExclude": "student\nfreelance",
            "profileBadge":           "Open to Work\nCreator",
            "industry":               "software development\nit services and it consulting",
            "industryExclude":        "staffing and recruiting",
            "size":                   "11-50",
            "hq":                     "Paris, France\nNew York, United States",
            "hqExclude":              "San Francisco, United States",
            "type":                   "PRIVATELY_HELD\nPUBLIC_COMPANY",
            "typeExclude":            "GOVERNMENT_AGENCY\nNON_PROFIT",
            "revenue":                "1000000-10000000",
            "companyKeywords":        "sales automation\nlead enrichment",
            "companyKeywordsExclude": "agency\nconsulting",
            "founded":                "2015-2022",
            "funding":                "SEED\nSERIES_A",
            "fundingAmount":          "1000000-5000000",
            "fundingDateMonths":      "12",
            "department":             "sales\n10-100",
            "growth":                 "sales\n20-80\n3 months",
            "searchMode":             "SMART",
        },
        "page": 0,
        "size": 25,
    }

    jsonPayload, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonPayload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://api.airscale.io/v1/leads-finder"

    payload := map[string]interface{}{
        "filters": map[string]interface{}{
            "job":                    []string{"Founder", "CEO", "VP Sales"},
            "jobExclude":             []string{"Intern", "Assistant"},
            "company":                []string{"airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"},
            "companyUrl":             []string{"airscale.io", "https://www.linkedin.com/company/openai"},
            "peopleLocation":         []string{"France", "Paris, France", "United States"},
            "peopleLocationExclude":  []string{"India", "Brazil"},
            "seniority":              "Founder\nC Suite\nVP\nDirector",
            "seniorityExclude":       "Intern\nEntry",
            "yearsCurrentRole":       "1 to 2 years",
            "yearsCurrentCompany":    "3 to 5 years",
            "yearsWorkExperience":    "More than 10 years",
            "skills":                 "lead generation\nsales automation\nprospecting",
            "skillsExclude":          "customer support",
            "language":               "English\nFrench",
            "languageExclude":        "Russian",
            "certification":          "HubSpot Sales Software\nSalesforce Administrator",
            "certificationExclude":   "Google Ads",
            "profileKeywords":        "growth\noutbound\nB2B",
            "profileKeywordsExclude": "student\nfreelance",
            "profileBadge":           "Open to Work\nCreator",
            "industry":               "software development\nit services and it consulting",
            "industryExclude":        "staffing and recruiting",
            "size":                   "11-50",
            "hq":                     "Paris, France\nNew York, United States",
            "hqExclude":              "San Francisco, United States",
            "type":                   "PRIVATELY_HELD\nPUBLIC_COMPANY",
            "typeExclude":            "GOVERNMENT_AGENCY\nNON_PROFIT",
            "revenue":                "1000000-10000000",
            "companyKeywords":        "sales automation\nlead enrichment",
            "companyKeywordsExclude": "agency\nconsulting",
            "founded":                "2015-2022",
            "funding":                "SEED\nSERIES_A",
            "fundingAmount":          "1000000-5000000",
            "fundingDateMonths":      "12",
            "department":             "sales\n10-100",
            "growth":                 "sales\n20-80\n3 months",
            "searchMode":             "SMART",
        },
        "page": 0,
        "size": 25,
    }

    jsonPayload, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonPayload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://api.airscale.io/v1/leads-finder"

    payload := map[string]interface{}{
        "filters": map[string]interface{}{
            "job":                    []string{"Founder", "CEO", "VP Sales"},
            "jobExclude":             []string{"Intern", "Assistant"},
            "company":                []string{"airscale.io", "OpenAI", "https://www.linkedin.com/company/airscale-io"},
            "companyUrl":             []string{"airscale.io", "https://www.linkedin.com/company/openai"},
            "peopleLocation":         []string{"France", "Paris, France", "United States"},
            "peopleLocationExclude":  []string{"India", "Brazil"},
            "seniority":              "Founder\nC Suite\nVP\nDirector",
            "seniorityExclude":       "Intern\nEntry",
            "yearsCurrentRole":       "1 to 2 years",
            "yearsCurrentCompany":    "3 to 5 years",
            "yearsWorkExperience":    "More than 10 years",
            "skills":                 "lead generation\nsales automation\nprospecting",
            "skillsExclude":          "customer support",
            "language":               "English\nFrench",
            "languageExclude":        "Russian",
            "certification":          "HubSpot Sales Software\nSalesforce Administrator",
            "certificationExclude":   "Google Ads",
            "profileKeywords":        "growth\noutbound\nB2B",
            "profileKeywordsExclude": "student\nfreelance",
            "profileBadge":           "Open to Work\nCreator",
            "industry":               "software development\nit services and it consulting",
            "industryExclude":        "staffing and recruiting",
            "size":                   "11-50",
            "hq":                     "Paris, France\nNew York, United States",
            "hqExclude":              "San Francisco, United States",
            "type":                   "PRIVATELY_HELD\nPUBLIC_COMPANY",
            "typeExclude":            "GOVERNMENT_AGENCY\nNON_PROFIT",
            "revenue":                "1000000-10000000",
            "companyKeywords":        "sales automation\nlead enrichment",
            "companyKeywordsExclude": "agency\nconsulting",
            "founded":                "2015-2022",
            "funding":                "SEED\nSERIES_A",
            "fundingAmount":          "1000000-5000000",
            "fundingDateMonths":      "12",
            "department":             "sales\n10-100",
            "growth":                 "sales\n20-80\n3 months",
            "searchMode":             "SMART",
        },
        "page": 0,
        "size": 25,
    }

    jsonPayload, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonPayload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body

API Overview

On this page

Title