Search People

curl -X POST https://api.dataforb2b.ai/search/people \
  -H "api_key: YOUR_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "op": "and",
      "conditions": [
        {"column": "current_title", "type": "like", "value": "Engineer"},
        {"column": "profile_country", "type": "=", "value": "US"}
      ]
    },
    "count": 10
  }'

import requests

response = requests.post(
    "https://api.dataforb2b.ai/search/people",
    headers={
        "api_key": "YOUR_api_key",
        "Content-Type": "application/json"
    },
    json={
        "filters": {
            "op": "and",
            "conditions": [
                {"column": "current_title", "type": "like", "value": "Engineer"},
                {"column": "profile_country", "type": "=", "value": "US"}
            ]
        },
        "count": 10
    }
)

data = response.json()
print(f"Found {data['total']} profiles")

const response = await fetch('https://api.dataforb2b.ai/search/people', {
  method: 'POST',
  headers: {
    'api_key': 'YOUR_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    filters: {
      op: 'and',
      conditions: [
        { column: 'current_title', type: 'like', value: 'Engineer' },
        { column: 'profile_country', type: '=', value: 'US' }
      ]
    },
    count: 10
  })
});

const data = await response.json();
console.log(`Found ${data.total} profiles`);

{
  "total": 10000,
  "total_is_capped": true,
  "offset": 0,
  "count": 2,
  "has_next_page": true,
  "credits_used": 1.5,
  "results": [
    {
      "id": "prof_PVURNGJihYludzaOwFCAwNajijSHFi6H0L9R",
      "first_name": "Sarah",
      "last_name": "Martinez",
      "headline": "Senior Software Engineer at Google | Cloud Infrastructure",
      "location": "San Francisco Bay Area, California",
      "country": "US",
      "industry": "Computer Software",
      "summary": "Passionate software engineer with 8+ years of experience building scalable cloud infrastructure. Specialized in Kubernetes, distributed systems, and site reliability engineering. Led multiple teams in delivering high-impact projects for millions of users.",
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/sarah-martinez-engineer",
        "twitter": "https://twitter.com/sarahdev",
        "github": "https://github.com/smartinez"
      },
      "experience": [
        {
          "company": {
            "id": "org_google",
            "name": "Google",
            "url": "https://linkedin.com/company/google",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Information Technology & Services"
          },
          "title": "Senior Software Engineer",
          "description": "Lead engineer for Google Cloud infrastructure, managing Kubernetes clusters at scale. Reduced deployment time by 40% through automation and improved system reliability to 99.99% uptime.",
          "employment_type": "Full-time",
          "location": "Mountain View, California",
          "duration_months": 36,
          "start_date": "2021-09",
          "end_date": null,
          "is_current": true
        },
        {
          "company": {
            "id": "org_amazon",
            "name": "Amazon",
            "url": "https://linkedin.com/company/amazon",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Internet"
          },
          "title": "Software Engineer II",
          "description": "Developed microservices for AWS infrastructure. Built monitoring and alerting systems processing millions of events daily.",
          "employment_type": "Full-time",
          "location": "Seattle, Washington",
          "duration_months": 30,
          "start_date": "2019-03",
          "end_date": "2021-08",
          "is_current": false
        },
        {
          "company": {
            "id": "org_microsoft",
            "name": "Microsoft",
            "url": "https://linkedin.com/company/microsoft",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Software Engineer",
          "description": "Azure infrastructure development and DevOps automation.",
          "employment_type": "Full-time",
          "location": "Redmond, Washington",
          "duration_months": 24,
          "start_date": "2017-03",
          "end_date": "2019-02",
          "is_current": false
        }
      ],
      "education": [
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZQlAmZ",
            "name": "Stanford University",
            "url": "https://www.linkedin.com/school/stanford-university/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Master of Science - MS",
          "field_of_study": "Computer Science",
          "activities": "Teaching Assistant for CS 106A",
          "grade": "3.9 GPA",
          "description": "Focus on distributed systems and machine learning",
          "start_date": "2015",
          "end_date": "2017"
        },
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZSAIQJ",
            "name": "UC Berkeley",
            "url": "https://www.linkedin.com/school/uc-berkeley/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Bachelor of Science - BS",
          "field_of_study": "Computer Engineering",
          "activities": "IEEE Computer Society, Hackathons",
          "grade": "3.8 GPA",
          "description": null,
          "start_date": "2011",
          "end_date": "2015"
        }
      ],
      "skills": [
        "Python",
        "Kubernetes",
        "Docker",
        "Go",
        "Terraform",
        "AWS",
        "Google Cloud Platform",
        "Distributed Systems",
        "Site Reliability Engineering",
        "CI/CD",
        "Monitoring & Alerting",
        "System Design"
      ],
      "certifications": [
        {
          "name": "Google Cloud Professional Architect",
          "authority": "Google Cloud",
          "url": "https://www.credential.net/...",
          "start_date": "2022-03",
          "end_date": "2025-03"
        },
        {
          "name": "Certified Kubernetes Administrator (CKA)",
          "authority": "Cloud Native Computing Foundation",
          "url": "https://www.credly.com/badges/...",
          "start_date": "2021-06",
          "end_date": "2024-06"
        }
      ],
      "languages": [
        {
          "name": "English",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "Spanish",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "French",
          "proficiency": "LIMITED_WORKING"
        }
      ],
      "metrics": {
        "followers": 4200,
        "skills_count": 12
      }
    },
    {
      "id": "prof_QWXj2MZKh65aYLdoLGDvwOckljTIGj7I1M0S",
      "first_name": "Michael",
      "last_name": "Chen",
      "headline": "Product Manager at Salesforce | B2B SaaS Expert",
      "location": "Seattle, Washington",
      "country": "US",
      "industry": "Computer Software",
      "summary": null,
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/michael-chen-pm",
        "twitter": null,
        "github": null
      },
      "experience": [
        {
          "company": {
            "id": "org_salesforce",
            "name": "Salesforce",
            "url": "https://linkedin.com/company/salesforce",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Senior Product Manager",
          "description": "Leading product strategy for enterprise CRM features. Managed a portfolio generating $50M+ ARR. Launched 3 major features adopted by 1000+ enterprise customers.",
          "employment_type": "Full-time",
          "location": "Seattle, Washington",
          "duration_months": 28,
          "start_date": "2022-05",
          "end_date": null,
          "is_current": true
        },
        {
          "company": {
            "id": "org_microsoft",
            "name": "Microsoft",
            "url": "https://linkedin.com/company/microsoft",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Product Manager",
          "description": "Product management for Microsoft Teams enterprise features",
          "employment_type": "Full-time",
          "location": "Redmond, Washington",
          "duration_months": 36,
          "start_date": "2019-05",
          "end_date": "2022-04",
          "is_current": false
        }
      ],
      "education": [
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZUTajN",
            "name": "MIT Sloan School of Management",
            "url": "https://www.linkedin.com/school/mit-sloan/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Master of Business Administration - MBA",
          "field_of_study": "Technology & Innovation Management",
          "activities": null,
          "grade": null,
          "description": null,
          "start_date": "2017",
          "end_date": "2019"
        },
        {
          "school": {
            "id": null,
            "name": "University of Washington",
            "url": null,
            "logo_url": null
          },
          "degree": "Bachelor of Science - BS",
          "field_of_study": "Business Administration",
          "activities": null,
          "grade": null,
          "description": null,
          "start_date": "2013",
          "end_date": "2017"
        }
      ],
      "skills": [
        "Product Management",
        "Product Strategy",
        "Agile Methodologies",
        "Roadmap Planning",
        "B2B SaaS",
        "User Research",
        "Data Analysis",
        "SQL",
        "A/B Testing"
      ],
      "certifications": [
        {
          "name": "Certified Scrum Product Owner (CSPO)",
          "authority": "Scrum Alliance",
          "url": null,
          "start_date": "2020-08",
          "end_date": null
        }
      ],
      "languages": [
        {
          "name": "English",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "Mandarin Chinese",
          "proficiency": "PROFESSIONAL_WORKING"
        }
      ],
      "metrics": {
        "followers": 2800,
        "skills_count": 9
      }
    }
  ]
}

POST

people

curl -X POST https://api.dataforb2b.ai/search/people \
  -H "api_key: YOUR_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "op": "and",
      "conditions": [
        {"column": "current_title", "type": "like", "value": "Engineer"},
        {"column": "profile_country", "type": "=", "value": "US"}
      ]
    },
    "count": 10
  }'

import requests

response = requests.post(
    "https://api.dataforb2b.ai/search/people",
    headers={
        "api_key": "YOUR_api_key",
        "Content-Type": "application/json"
    },
    json={
        "filters": {
            "op": "and",
            "conditions": [
                {"column": "current_title", "type": "like", "value": "Engineer"},
                {"column": "profile_country", "type": "=", "value": "US"}
            ]
        },
        "count": 10
    }
)

data = response.json()
print(f"Found {data['total']} profiles")

const response = await fetch('https://api.dataforb2b.ai/search/people', {
  method: 'POST',
  headers: {
    'api_key': 'YOUR_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    filters: {
      op: 'and',
      conditions: [
        { column: 'current_title', type: 'like', value: 'Engineer' },
        { column: 'profile_country', type: '=', value: 'US' }
      ]
    },
    count: 10
  })
});

const data = await response.json();
console.log(`Found ${data.total} profiles`);

{
  "total": 10000,
  "total_is_capped": true,
  "offset": 0,
  "count": 2,
  "has_next_page": true,
  "credits_used": 1.5,
  "results": [
    {
      "id": "prof_PVURNGJihYludzaOwFCAwNajijSHFi6H0L9R",
      "first_name": "Sarah",
      "last_name": "Martinez",
      "headline": "Senior Software Engineer at Google | Cloud Infrastructure",
      "location": "San Francisco Bay Area, California",
      "country": "US",
      "industry": "Computer Software",
      "summary": "Passionate software engineer with 8+ years of experience building scalable cloud infrastructure. Specialized in Kubernetes, distributed systems, and site reliability engineering. Led multiple teams in delivering high-impact projects for millions of users.",
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/sarah-martinez-engineer",
        "twitter": "https://twitter.com/sarahdev",
        "github": "https://github.com/smartinez"
      },
      "experience": [
        {
          "company": {
            "id": "org_google",
            "name": "Google",
            "url": "https://linkedin.com/company/google",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Information Technology & Services"
          },
          "title": "Senior Software Engineer",
          "description": "Lead engineer for Google Cloud infrastructure, managing Kubernetes clusters at scale. Reduced deployment time by 40% through automation and improved system reliability to 99.99% uptime.",
          "employment_type": "Full-time",
          "location": "Mountain View, California",
          "duration_months": 36,
          "start_date": "2021-09",
          "end_date": null,
          "is_current": true
        },
        {
          "company": {
            "id": "org_amazon",
            "name": "Amazon",
            "url": "https://linkedin.com/company/amazon",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Internet"
          },
          "title": "Software Engineer II",
          "description": "Developed microservices for AWS infrastructure. Built monitoring and alerting systems processing millions of events daily.",
          "employment_type": "Full-time",
          "location": "Seattle, Washington",
          "duration_months": 30,
          "start_date": "2019-03",
          "end_date": "2021-08",
          "is_current": false
        },
        {
          "company": {
            "id": "org_microsoft",
            "name": "Microsoft",
            "url": "https://linkedin.com/company/microsoft",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Software Engineer",
          "description": "Azure infrastructure development and DevOps automation.",
          "employment_type": "Full-time",
          "location": "Redmond, Washington",
          "duration_months": 24,
          "start_date": "2017-03",
          "end_date": "2019-02",
          "is_current": false
        }
      ],
      "education": [
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZQlAmZ",
            "name": "Stanford University",
            "url": "https://www.linkedin.com/school/stanford-university/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Master of Science - MS",
          "field_of_study": "Computer Science",
          "activities": "Teaching Assistant for CS 106A",
          "grade": "3.9 GPA",
          "description": "Focus on distributed systems and machine learning",
          "start_date": "2015",
          "end_date": "2017"
        },
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZSAIQJ",
            "name": "UC Berkeley",
            "url": "https://www.linkedin.com/school/uc-berkeley/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Bachelor of Science - BS",
          "field_of_study": "Computer Engineering",
          "activities": "IEEE Computer Society, Hackathons",
          "grade": "3.8 GPA",
          "description": null,
          "start_date": "2011",
          "end_date": "2015"
        }
      ],
      "skills": [
        "Python",
        "Kubernetes",
        "Docker",
        "Go",
        "Terraform",
        "AWS",
        "Google Cloud Platform",
        "Distributed Systems",
        "Site Reliability Engineering",
        "CI/CD",
        "Monitoring & Alerting",
        "System Design"
      ],
      "certifications": [
        {
          "name": "Google Cloud Professional Architect",
          "authority": "Google Cloud",
          "url": "https://www.credential.net/...",
          "start_date": "2022-03",
          "end_date": "2025-03"
        },
        {
          "name": "Certified Kubernetes Administrator (CKA)",
          "authority": "Cloud Native Computing Foundation",
          "url": "https://www.credly.com/badges/...",
          "start_date": "2021-06",
          "end_date": "2024-06"
        }
      ],
      "languages": [
        {
          "name": "English",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "Spanish",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "French",
          "proficiency": "LIMITED_WORKING"
        }
      ],
      "metrics": {
        "followers": 4200,
        "skills_count": 12
      }
    },
    {
      "id": "prof_QWXj2MZKh65aYLdoLGDvwOckljTIGj7I1M0S",
      "first_name": "Michael",
      "last_name": "Chen",
      "headline": "Product Manager at Salesforce | B2B SaaS Expert",
      "location": "Seattle, Washington",
      "country": "US",
      "industry": "Computer Software",
      "summary": null,
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/michael-chen-pm",
        "twitter": null,
        "github": null
      },
      "experience": [
        {
          "company": {
            "id": "org_salesforce",
            "name": "Salesforce",
            "url": "https://linkedin.com/company/salesforce",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Senior Product Manager",
          "description": "Leading product strategy for enterprise CRM features. Managed a portfolio generating $50M+ ARR. Launched 3 major features adopted by 1000+ enterprise customers.",
          "employment_type": "Full-time",
          "location": "Seattle, Washington",
          "duration_months": 28,
          "start_date": "2022-05",
          "end_date": null,
          "is_current": true
        },
        {
          "company": {
            "id": "org_microsoft",
            "name": "Microsoft",
            "url": "https://linkedin.com/company/microsoft",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Product Manager",
          "description": "Product management for Microsoft Teams enterprise features",
          "employment_type": "Full-time",
          "location": "Redmond, Washington",
          "duration_months": 36,
          "start_date": "2019-05",
          "end_date": "2022-04",
          "is_current": false
        }
      ],
      "education": [
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZUTajN",
            "name": "MIT Sloan School of Management",
            "url": "https://www.linkedin.com/school/mit-sloan/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Master of Business Administration - MBA",
          "field_of_study": "Technology & Innovation Management",
          "activities": null,
          "grade": null,
          "description": null,
          "start_date": "2017",
          "end_date": "2019"
        },
        {
          "school": {
            "id": null,
            "name": "University of Washington",
            "url": null,
            "logo_url": null
          },
          "degree": "Bachelor of Science - BS",
          "field_of_study": "Business Administration",
          "activities": null,
          "grade": null,
          "description": null,
          "start_date": "2013",
          "end_date": "2017"
        }
      ],
      "skills": [
        "Product Management",
        "Product Strategy",
        "Agile Methodologies",
        "Roadmap Planning",
        "B2B SaaS",
        "User Research",
        "Data Analysis",
        "SQL",
        "A/B Testing"
      ],
      "certifications": [
        {
          "name": "Certified Scrum Product Owner (CSPO)",
          "authority": "Scrum Alliance",
          "url": null,
          "start_date": "2020-08",
          "end_date": null
        }
      ],
      "languages": [
        {
          "name": "English",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "Mandarin Chinese",
          "proficiency": "PROFESSIONAL_WORKING"
        }
      ],
      "metrics": {
        "followers": 2800,
        "skills_count": 9
      }
    }
  ]
}

Credit Cost

0.75 credits per result.

Need access to additional filters? Contact us at [email protected] with your use case.

Request Body

object

Filter group to apply to the search. See Filters section below.

string

required

Logical operator to combine conditions.

and - All conditions must match
or - At least one condition must match

array

required

Array of filter conditions or nested filter groups.

string

required

Column name to filter on. See Available Columns section below for complete list with data types and recommended operators.Profile: first_name, last_name, profile_location, profile_country, profile_industry, follower_count, keywordCurrent Job: current_company, current_title, current_job_location, current_company_industry, current_company_category, current_company_size (values: 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+), current_company_id, current_employment_type, years_in_current_position, years_at_current_company, current_company_has_funding, current_company_funding_stage, current_company_investorPast Jobs: past_company, past_title, past_company_industry, past_company_size (same values as current_company_size), past_company_id, past_employment_type, years_at_past_companySkills: skill (e.g., “Python”, “JavaScript”, “Machine Learning”)Education: school, degree, degree_level (Bachelor, Master, PhD, Associate, Certificate, High School), field_of_studyLanguages: language (full name), language_iso (ISO code like “en”, “fr”), language_proficiency (NATIVE_OR_BILINGUAL, FULL_PROFESSIONAL, PROFESSIONAL_WORKING, LIMITED_WORKING, ELEMENTARY)Certifications: certification, certification_authorityExperience: years_of_experience (total career), num_total_jobs (number of positions), is_currently_employed (boolean)

string

required

Comparison operator to use. Available operators:

= - Exact match
> - Greater than
>= - Greater than or equal
< - Less than
<= - Less than or equal
between - Between two values (requires value2)
in - Value is in a list
like - Text search (pattern matching)

any

Filter value to compare against.

any

Second value (only used with between operator).

integer

default:"0"

Number of results to skip for pagination.

integer

default:"25"

Number of results to return. Maximum: 5000.

Filters System

A FilterGroup combines multiple conditions with a logical operator:

{
  "op": "and",
  "conditions": [...]
}

Field	Type	Description
`op`	string	Logical operator: `"and"` or `"or"`
`conditions`	array	List of `FilterCondition` or nested `FilterGroup` (recursive)

FilterCondition Structure

{
  "column": "first_name",
  "type": "=",
  "value": "John",
  "value2": null
}

Field	Type	Description
`column`	string	Column name to filter on
`type`	string	Operator type (see below)
`value`	any	Filter value
`value2`	any	Second value (only for `between` operator)

Available Operators

Operator	Description	Example
`=`	Exact match	`{"column": "first_name", "type": "=", "value": "John"}`
`>`	Greater than	`{"column": "follower_count", "type": ">", "value": 1000}`
`>=`	Greater than or equal	`{"column": "years_of_experience", "type": ">=", "value": 5}`
`<`	Less than	`{"column": "years_at_current_company", "type": "<", "value": 2}`
`<=`	Less than or equal	`{"column": "follower_count", "type": "<=", "value": 500}`
`between`	Between two values	`{"column": "years_of_experience", "type": "between", "value": 3, "value2": 7}`
`in`	In a list	`{"column": "profile_country", "type": "in", "value": ["US", "GB", "CA"]}`
`like`	Text search	`{"column": "current_title", "type": "like", "value": "Engineer"}`

How text matching works

The operator controls how text is matched — there are no separator characters (comma, pipe, etc.):

= matches the exact value, case-insensitive. On multi-word fields it matches the full phrase, in order — current_company = "Y Combinator" matches, "Combinator Y" does not.
like matches records where all the words appear, in any order — the best choice for partial or keyword search. keyword like "growth marketing" matches “Growth & Performance Marketing Lead”.
in takes a JSON array and matches any value in it (OR): "value": ["Google", "Meta"]. A comma-separated string like "Google,Meta" is rejected with a 400 error — always pass an array.

Titles are free-form (e.g. “Senior Software Engineer, Platform @ Acme”), so search for the part that matters — current_title like "software engineer" — rather than a full exact title.

Available Columns

Profile

Column	Type	Recommended Operators	Description
`first_name`	text	`=`, `like`, `in`	Person’s first name
`last_name`	text	`=`, `like`, `in`	Person’s last name
`profile_location`	text	`=`, `like`	Current location (city, state)
`profile_country`	text	`=`, `in`	Country code ISO 2 letters, uppercase (e.g., “US”, “GB”, “FR”, “DE”, “CA”). Note: use `GB` (not `UK`) for United Kingdom
`profile_industry`	text	`=`, `like`, `in`	Profile industry
`follower_count`	int	`=`, `>`, `>=`, `<`, `<=`, `between`	Number of profile followers
`keyword`	text	`like`	Full-text search in headline (trigram matching)

Current Job

Column	Type	Operators	Description
`current_company`	text	`=`, `like`, `in`	Current employer name
`current_title`	text	`=`, `like`, `in`	Current job title. Use `like` with the key part of the title, e.g. `"software engineer"` (all words must appear, any order); `=` matches the exact phrase in order
`current_job_location`	text	`=`, `like`, `in`	Current job location (city, state)
`current_company_industry`	text	`=`, `like`, `in`	Industry of current employer, capitalized (e.g., “Information Technology & Services”, “Computer Software”, “Hospital & Health Care”, “Financial Services”, “Marketing & Advertising”)
`current_company_category`	text	`=`, `like`, `in`	Category of current employer, lowercase (e.g., `software`, `consulting`, `financial services`, `e-commerce`, `health care`)
`current_company_size`	text	`=`, `in`	Company size range (`2-10`, `11-50`, `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001-10000`, `10001+`)
`current_company_id`	text	`=`, `in`	Company identifier
`current_employment_type`	text	`=`, `in`	Employment type. Values: “Full-time”, “Part-time”, “Self-employed”, “Freelance”, “Contract”, “Permanent”, “Permanent Full-time”, “Permanent Part-time”, “Contract Full-time”, “Contract Part-time”, “Internship”, “Apprenticeship”, “Seasonal”
`years_in_current_position`	int	`=`, `>`, `>=`, `<`, `<=`, `between`	Years in current role
`years_at_current_company`	int	`=`, `>`, `>=`, `<`, `<=`, `between`	Years at current company
`current_company_has_funding`	bool	`=`	Whether the current company has received funding (true/false)
`current_company_funding_stage`	text	`=`, `in`	Funding stage of the current company. Values: `seed_round`, `series_a`, `series_b`, `series_c`, `series_d`, `series_e`, `series_f`, `series_g`, `series_h`, `series_unknown`, `pre_seed_round`, `angel_round`, `grant`, `private_equity_round`, `debt_financing`, `convertible_note`, `corporate_round`, `equity_crowdfunding`, `post_ipo_equity`, `post_ipo_debt`, `post_ipo_secondary`, `secondary_market`, `non_equity_assistance`, `product_crowdfunding`, `initial_coin_offering`, `undisclosed`. Note: data also contains some legacy values without `_round` suffix (`seed`, `pre_seed`, `angel`, `private_equity`) — use `in` with both forms for max coverage
`current_company_investor`	text	`=`, `like`, `in`	Investor name of the current company. Supports partial matching with `like`

Past Jobs

Column	Type	Operators	Description
`past_company`	text	`=`, `like`, `in`	Former employer name
`past_title`	text	`=`, `like`, `in`	Previous job title. Same matching as `current_title`: `like` = all words in any order, `=` = exact phrase in order
`past_company_industry`	text	`=`, `like`, `in`	Industry of former employer
`past_company_size`	text	`=`, `in`	Former company size range (same values as current_company_size)
`past_company_id`	text	`=`, `in`	Company identifier of former employer
`past_employment_type`	text	`=`, `in`	Past employment type
`years_at_past_company`	int	`=`, `>`, `>=`, `<`, `<=`, `between`	Years spent at former company

Skills

Column	Type	Operators	Description
`skill`	text	`=`, `like`, `in`	Skills listed on profile (e.g., “Python”, “JavaScript”, “Machine Learning”)

Education

Column	Type	Operators	Description
`school`	text	`=`, `like`, `in`	Educational institution name
`degree`	text	`=`, `like`, `in`	Degree name
`degree_level`	text	`=`, `in`	Normalized degree level. Values: `Bachelor`, `Master`, `PhD`, `Associate`, `Certificate`, `High School`, `Other`. Only set on a small share of profiles — for broad coverage use `degree` with `like` (e.g. `"master"`)
`field_of_study`	text	`=`, `like`, `in`	Major or field of study

Languages

Column	Type	Operators	Description
`language`	text	`=`, `like`, `in`	Language name (e.g., “English”, “French”, “Spanish”)
`language_iso`	text	`=`, `in`	ISO language code (e.g., “en”, “fr”, “es”)
`language_proficiency`	text	`=`, `in`	Proficiency level. Values: `NATIVE_OR_BILINGUAL`, `FULL_PROFESSIONAL`, `PROFESSIONAL_WORKING`, `LIMITED_WORKING`, `ELEMENTARY`

Certifications

Column	Type	Operators	Description
`certification`	text	`=`, `like`, `in`	Certification name (e.g., “AWS Certified”, “PMP”, “CPA”)
`certification_authority`	text	`=`, `like`, `in`	Issuing organization (e.g., “Amazon Web Services”, “PMI”)

Experience

Column	Type	Operators	Description
`years_of_experience`	int	`=`, `>`, `>=`, `<`, `<=`, `between`	Total years of professional experience
`num_total_jobs`	int	`=`, `>`, `>=`, `<`, `<=`, `between`	Total number of positions held
`is_currently_employed`	bool	`=`	Whether person is currently employed (true/false)

Complex Query Examples

Senior developers at FAANG companies

{
  "filters": {
    "op": "and",
    "conditions": [
      {"column": "current_company", "type": "in", "value": ["Google", "Apple", "Facebook", "Amazon", "Microsoft"]},
      {"column": "current_title", "type": "like", "value": "Senior"},
      {"column": "skill", "type": "in", "value": ["Python", "Java", "Go"]},
      {"column": "years_of_experience", "type": ">=", "value": 8}
    ]
  },
  "count": 100
}

Ex-consultants from McKinsey/BCG now at startups

{
  "filters": {
    "op": "and",
    "conditions": [
      {"column": "past_company", "type": "in", "value": ["McKinsey", "BCG", "Bain"]},
      {"column": "current_company_size", "type": "in", "value": ["2-10", "11-50"]},
      {"column": "current_title", "type": "like", "value": "Founder"}
    ]
  },
  "count": 50
}

Engineers at Series A/B funded companies backed by Sequoia

{
  "filters": {
    "op": "and",
    "conditions": [
      {"column": "current_title", "type": "like", "value": "Engineer"},
      {"column": "current_company_has_funding", "type": "=", "value": true},
      {"column": "current_company_funding_stage", "type": "in", "value": ["series_a", "series_b"]},
      {"column": "current_company_investor", "type": "like", "value": "Sequoia"}
    ]
  },
  "count": 50
}

OR search (profiles with Python OR JavaScript)

{
  "filters": {
    "op": "and",
    "conditions": [
      {"column": "profile_country", "type": "=", "value": "US"},
      {
        "op": "or",
        "conditions": [
          {"column": "skill", "type": "=", "value": "Python"},
          {"column": "skill", "type": "=", "value": "JavaScript"}
        ]
      }
    ]
  }
}

Response

integer

Total number of results matching the filters. Capped at 10,000.

boolean

true when total reached the 10,000 cap — the real count is higher (display it as “10,000+”).

integer

Offset used for pagination.

integer

Number of results returned in this response.

boolean

Whether more results are available. Use it with offset to paginate.

number

Credits charged for this request.

array

List of profiles matching the filters.

Show profile item properties

string

Encoded profile ID (prof_xxx) — pass it to Enrich Profile

string

First name

string

Last name

string | null

Professional headline

string | null

Current location

string | null

Country code ISO 2 letters (e.g., “US”, “GB”, “FR”)

string | null

Profile industry

string | null

Profile summary/bio

string | null

Profile language code (e.g., “en_US”)

string | null

Profile picture URL

object

Profile links: linkedin, twitter, github (each a URL or null)

array

Work experience. Each item has a company object (id, name, url, logo_url, size, industry), title, description, employment_type, location, duration_months, start_date (YYYY-MM), end_date (YYYY-MM, null if current) and is_current.

array

Education history. Each item has a school object (id, name, url, logo_url), degree, field_of_study, activities, grade, description, start_date and end_date (years).

array

Skill names (strings)

array

Certifications: name, authority, url, start_date, end_date

array

Languages: name and proficiency (NATIVE_OR_BILINGUAL, FULL_PROFESSIONAL, PROFESSIONAL_WORKING, LIMITED_WORKING, ELEMENTARY)

object

followers and skills_count

curl -X POST https://api.dataforb2b.ai/search/people \
  -H "api_key: YOUR_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "op": "and",
      "conditions": [
        {"column": "current_title", "type": "like", "value": "Engineer"},
        {"column": "profile_country", "type": "=", "value": "US"}
      ]
    },
    "count": 10
  }'

import requests

response = requests.post(
    "https://api.dataforb2b.ai/search/people",
    headers={
        "api_key": "YOUR_api_key",
        "Content-Type": "application/json"
    },
    json={
        "filters": {
            "op": "and",
            "conditions": [
                {"column": "current_title", "type": "like", "value": "Engineer"},
                {"column": "profile_country", "type": "=", "value": "US"}
            ]
        },
        "count": 10
    }
)

data = response.json()
print(f"Found {data['total']} profiles")

const response = await fetch('https://api.dataforb2b.ai/search/people', {
  method: 'POST',
  headers: {
    'api_key': 'YOUR_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    filters: {
      op: 'and',
      conditions: [
        { column: 'current_title', type: 'like', value: 'Engineer' },
        { column: 'profile_country', type: '=', value: 'US' }
      ]
    },
    count: 10
  })
});

const data = await response.json();
console.log(`Found ${data.total} profiles`);

{
  "total": 10000,
  "total_is_capped": true,
  "offset": 0,
  "count": 2,
  "has_next_page": true,
  "credits_used": 1.5,
  "results": [
    {
      "id": "prof_PVURNGJihYludzaOwFCAwNajijSHFi6H0L9R",
      "first_name": "Sarah",
      "last_name": "Martinez",
      "headline": "Senior Software Engineer at Google | Cloud Infrastructure",
      "location": "San Francisco Bay Area, California",
      "country": "US",
      "industry": "Computer Software",
      "summary": "Passionate software engineer with 8+ years of experience building scalable cloud infrastructure. Specialized in Kubernetes, distributed systems, and site reliability engineering. Led multiple teams in delivering high-impact projects for millions of users.",
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/sarah-martinez-engineer",
        "twitter": "https://twitter.com/sarahdev",
        "github": "https://github.com/smartinez"
      },
      "experience": [
        {
          "company": {
            "id": "org_google",
            "name": "Google",
            "url": "https://linkedin.com/company/google",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Information Technology & Services"
          },
          "title": "Senior Software Engineer",
          "description": "Lead engineer for Google Cloud infrastructure, managing Kubernetes clusters at scale. Reduced deployment time by 40% through automation and improved system reliability to 99.99% uptime.",
          "employment_type": "Full-time",
          "location": "Mountain View, California",
          "duration_months": 36,
          "start_date": "2021-09",
          "end_date": null,
          "is_current": true
        },
        {
          "company": {
            "id": "org_amazon",
            "name": "Amazon",
            "url": "https://linkedin.com/company/amazon",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Internet"
          },
          "title": "Software Engineer II",
          "description": "Developed microservices for AWS infrastructure. Built monitoring and alerting systems processing millions of events daily.",
          "employment_type": "Full-time",
          "location": "Seattle, Washington",
          "duration_months": 30,
          "start_date": "2019-03",
          "end_date": "2021-08",
          "is_current": false
        },
        {
          "company": {
            "id": "org_microsoft",
            "name": "Microsoft",
            "url": "https://linkedin.com/company/microsoft",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Software Engineer",
          "description": "Azure infrastructure development and DevOps automation.",
          "employment_type": "Full-time",
          "location": "Redmond, Washington",
          "duration_months": 24,
          "start_date": "2017-03",
          "end_date": "2019-02",
          "is_current": false
        }
      ],
      "education": [
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZQlAmZ",
            "name": "Stanford University",
            "url": "https://www.linkedin.com/school/stanford-university/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Master of Science - MS",
          "field_of_study": "Computer Science",
          "activities": "Teaching Assistant for CS 106A",
          "grade": "3.9 GPA",
          "description": "Focus on distributed systems and machine learning",
          "start_date": "2015",
          "end_date": "2017"
        },
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZSAIQJ",
            "name": "UC Berkeley",
            "url": "https://www.linkedin.com/school/uc-berkeley/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Bachelor of Science - BS",
          "field_of_study": "Computer Engineering",
          "activities": "IEEE Computer Society, Hackathons",
          "grade": "3.8 GPA",
          "description": null,
          "start_date": "2011",
          "end_date": "2015"
        }
      ],
      "skills": [
        "Python",
        "Kubernetes",
        "Docker",
        "Go",
        "Terraform",
        "AWS",
        "Google Cloud Platform",
        "Distributed Systems",
        "Site Reliability Engineering",
        "CI/CD",
        "Monitoring & Alerting",
        "System Design"
      ],
      "certifications": [
        {
          "name": "Google Cloud Professional Architect",
          "authority": "Google Cloud",
          "url": "https://www.credential.net/...",
          "start_date": "2022-03",
          "end_date": "2025-03"
        },
        {
          "name": "Certified Kubernetes Administrator (CKA)",
          "authority": "Cloud Native Computing Foundation",
          "url": "https://www.credly.com/badges/...",
          "start_date": "2021-06",
          "end_date": "2024-06"
        }
      ],
      "languages": [
        {
          "name": "English",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "Spanish",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "French",
          "proficiency": "LIMITED_WORKING"
        }
      ],
      "metrics": {
        "followers": 4200,
        "skills_count": 12
      }
    },
    {
      "id": "prof_QWXj2MZKh65aYLdoLGDvwOckljTIGj7I1M0S",
      "first_name": "Michael",
      "last_name": "Chen",
      "headline": "Product Manager at Salesforce | B2B SaaS Expert",
      "location": "Seattle, Washington",
      "country": "US",
      "industry": "Computer Software",
      "summary": null,
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/michael-chen-pm",
        "twitter": null,
        "github": null
      },
      "experience": [
        {
          "company": {
            "id": "org_salesforce",
            "name": "Salesforce",
            "url": "https://linkedin.com/company/salesforce",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Senior Product Manager",
          "description": "Leading product strategy for enterprise CRM features. Managed a portfolio generating $50M+ ARR. Launched 3 major features adopted by 1000+ enterprise customers.",
          "employment_type": "Full-time",
          "location": "Seattle, Washington",
          "duration_months": 28,
          "start_date": "2022-05",
          "end_date": null,
          "is_current": true
        },
        {
          "company": {
            "id": "org_microsoft",
            "name": "Microsoft",
            "url": "https://linkedin.com/company/microsoft",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "10001+",
            "industry": "Computer Software"
          },
          "title": "Product Manager",
          "description": "Product management for Microsoft Teams enterprise features",
          "employment_type": "Full-time",
          "location": "Redmond, Washington",
          "duration_months": 36,
          "start_date": "2019-05",
          "end_date": "2022-04",
          "is_current": false
        }
      ],
      "education": [
        {
          "school": {
            "id": "edu_0lox4Unn3pMSqjJXEFXX1n5YqgKPsQZUTajN",
            "name": "MIT Sloan School of Management",
            "url": "https://www.linkedin.com/school/mit-sloan/",
            "logo_url": "https://media.licdn.com/dms/image/..."
          },
          "degree": "Master of Business Administration - MBA",
          "field_of_study": "Technology & Innovation Management",
          "activities": null,
          "grade": null,
          "description": null,
          "start_date": "2017",
          "end_date": "2019"
        },
        {
          "school": {
            "id": null,
            "name": "University of Washington",
            "url": null,
            "logo_url": null
          },
          "degree": "Bachelor of Science - BS",
          "field_of_study": "Business Administration",
          "activities": null,
          "grade": null,
          "description": null,
          "start_date": "2013",
          "end_date": "2017"
        }
      ],
      "skills": [
        "Product Management",
        "Product Strategy",
        "Agile Methodologies",
        "Roadmap Planning",
        "B2B SaaS",
        "User Research",
        "Data Analysis",
        "SQL",
        "A/B Testing"
      ],
      "certifications": [
        {
          "name": "Certified Scrum Product Owner (CSPO)",
          "authority": "Scrum Alliance",
          "url": null,
          "start_date": "2020-08",
          "end_date": null
        }
      ],
      "languages": [
        {
          "name": "English",
          "proficiency": "NATIVE_OR_BILINGUAL"
        },
        {
          "name": "Mandarin Chinese",
          "proficiency": "PROFESSIONAL_WORKING"
        }
      ],
      "metrics": {
        "followers": 2800,
        "skills_count": 9
      }
    }
  ]
}

Get Started

Search

AI Search

Enrichment

Tools

Account

Development

Credit Cost

Request Body

Filters System

FilterGroup Structure

FilterCondition Structure

Available Operators

How text matching works

Available Columns

Profile

Current Job

Past Jobs

Skills

Education

Languages

Certifications

Experience

Complex Query Examples

Response

​Credit Cost

​Request Body

​Filters System

​FilterGroup Structure

​FilterCondition Structure

​Available Operators

​How text matching works

​Available Columns

​Profile

​Current Job

​Past Jobs

​Skills

​Education

​Languages

​Certifications

​Experience

​Complex Query Examples

​Response

Credit Cost

Request Body

Filters System

FilterGroup Structure

FilterCondition Structure

Available Operators

How text matching works

Available Columns

Profile

Current Job

Past Jobs

Skills

Education

Languages

Certifications

Experience

Complex Query Examples

Response