People Search - People Data Labs

curl --request POST \
  --url https://api.getanyapi.com/v1/run/people_search.peopledatalabs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "limit": 1,
  "sql": "SELECT * FROM person WHERE job_company_website = 'posthog.com'"
}
EOF

import requests

url = "https://api.getanyapi.com/v1/run/people_search.peopledatalabs"

payload = {
    "limit": 1,
    "sql": "SELECT * FROM person WHERE job_company_website = 'posthog.com'"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    limit: 1,
    sql: 'SELECT * FROM person WHERE job_company_website = \'posthog.com\''
  })
};

fetch('https://api.getanyapi.com/v1/run/people_search.peopledatalabs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getanyapi.com/v1/run/people_search.peopledatalabs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'limit' => 1,
    'sql' => 'SELECT * FROM person WHERE job_company_website = \'posthog.com\''
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getanyapi.com/v1/run/people_search.peopledatalabs"

	payload := strings.NewReader("{\n  \"limit\": 1,\n  \"sql\": \"SELECT * FROM person WHERE job_company_website = 'posthog.com'\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.getanyapi.com/v1/run/people_search.peopledatalabs")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 1,\n  \"sql\": \"SELECT * FROM person WHERE job_company_website = 'posthog.com'\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getanyapi.com/v1/run/people_search.peopledatalabs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"limit\": 1,\n  \"sql\": \"SELECT * FROM person WHERE job_company_website = 'posthog.com'\"\n}"

response = http.request(request)
puts response.read_body

{
  "costUsd": 123,
  "items": 123,
  "output": {
    "data": {
      "people": [
        {
          "fullName": "<string>",
          "activityScore": "<string>",
          "available": {
            "birthDate": true,
            "birthYear": true,
            "facebookId": true,
            "facebookUrl": true,
            "facebookUsername": true,
            "githubUrl": true,
            "githubUsername": true,
            "locationAddressLine2": true,
            "locationStreetAddress": true,
            "mobilePhone": true,
            "personalEmails": true,
            "phoneNumbers": true,
            "recommendedPersonalEmail": true,
            "streetAddresses": true,
            "twitterUrl": true,
            "twitterUsername": true,
            "workEmail": true
          },
          "companyAddressLine2": "<string>",
          "companyContinent": "<string>",
          "companyFacebookUrl": "<string>",
          "companyFounded": 123,
          "companyGeo": "<string>",
          "companyId": "<string>",
          "companyIndustry": "<string>",
          "companyIndustryV2": "<string>",
          "companyLinkedinId": "<string>",
          "companyLinkedinUrl": "<string>",
          "companyLocality": "<string>",
          "companyLocationCountry": "<string>",
          "companyLocationName": "<string>",
          "companyMetro": "<string>",
          "companyName": "<string>",
          "companyPostalCode": "<string>",
          "companyRegion": "<string>",
          "companySize": "<string>",
          "companyStreetAddress": "<string>",
          "companyTwitterUrl": "<string>",
          "companyWebsite": "<string>",
          "continent": "<string>",
          "countries": [
            "<string>"
          ],
          "country": "<string>",
          "education": [
            {
              "degrees": [
                "<string>"
              ],
              "endDate": "<string>",
              "gpa": 123,
              "majors": [
                "<string>"
              ],
              "minors": [
                "<string>"
              ],
              "schoolName": "<string>",
              "schoolType": "<string>",
              "schoolWebsite": "<string>",
              "startDate": "<string>"
            }
          ],
          "emails": [
            {
              "type": "<string>"
            }
          ],
          "experience": [
            {
              "companyId": "<string>",
              "companyIndustry": "<string>",
              "companyLinkedinUrl": "<string>",
              "companyName": "<string>",
              "companySize": "<string>",
              "companyWebsite": "<string>",
              "endDate": "<string>",
              "isPrimary": true,
              "startDate": "<string>",
              "title": "<string>",
              "titleLevels": [
                "<string>"
              ],
              "titleRole": "<string>"
            }
          ],
          "firstName": "<string>",
          "geo": "<string>",
          "industry": "<string>",
          "interests": [
            "<string>"
          ],
          "jobChangedUtc": 123,
          "jobStartDate": "<string>",
          "jobTitle": "<string>",
          "jobTitleClass": "<string>",
          "jobTitleLevels": [
            "<string>"
          ],
          "jobTitleRole": "<string>",
          "jobTitleSubRole": "<string>",
          "jobVerifiedUtc": 123,
          "lastInitial": "<string>",
          "lastName": "<string>",
          "linkedinId": "<string>",
          "linkedinUrl": "<string>",
          "linkedinUsername": "<string>",
          "locality": "<string>",
          "locationName": "<string>",
          "locationNames": [
            "<string>"
          ],
          "locationUpdatedUtc": 123,
          "metro": "<string>",
          "middleInitial": "<string>",
          "middleName": "<string>",
          "pdlId": "<string>",
          "postalCode": "<string>",
          "profileScore": "<string>",
          "profiles": [
            {
              "network": "<string>"
            }
          ],
          "region": "<string>",
          "regions": [
            "<string>"
          ],
          "sex": "<string>",
          "skills": [
            "<string>"
          ]
        }
      ],
      "datasetVersion": "<string>",
      "total": 123
    },
    "found": true
  },
  "provider": "<string>",
  "replayed": true,
  "hint": "<string>",
  "jqError": "<string>",
  "resultId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

People_search

People Search - People Data Labs

Search People Data Labs’ person dataset with SQL or an Elasticsearch query. Results carry the professional and firmographic record plus availability flags for contact data; pull the actual email and phone with Person Enrichment - People Data Labs. Billed per profile returned.

Price: billed per result - $168.00 per 1,000 results, capped at $9,912.00 per 1,000 requests.

Routing: one lane serves this API today, so a failed attempt has nowhere to fail over to. Payment outcome follows the selected rail’s settlement policy.

Catalog: People Search - People Data Labs pricing and uptime - live USD price, lane routing, and measured 30-day uptime. Every People_search endpoint.

POST

run

people_search.peopledatalabs

People Search - People Data Labs

curl --request POST \
  --url https://api.getanyapi.com/v1/run/people_search.peopledatalabs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "limit": 1,
  "sql": "SELECT * FROM person WHERE job_company_website = 'posthog.com'"
}
EOF

import requests

url = "https://api.getanyapi.com/v1/run/people_search.peopledatalabs"

payload = {
    "limit": 1,
    "sql": "SELECT * FROM person WHERE job_company_website = 'posthog.com'"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    limit: 1,
    sql: 'SELECT * FROM person WHERE job_company_website = \'posthog.com\''
  })
};

fetch('https://api.getanyapi.com/v1/run/people_search.peopledatalabs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getanyapi.com/v1/run/people_search.peopledatalabs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'limit' => 1,
    'sql' => 'SELECT * FROM person WHERE job_company_website = \'posthog.com\''
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getanyapi.com/v1/run/people_search.peopledatalabs"

	payload := strings.NewReader("{\n  \"limit\": 1,\n  \"sql\": \"SELECT * FROM person WHERE job_company_website = 'posthog.com'\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.getanyapi.com/v1/run/people_search.peopledatalabs")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 1,\n  \"sql\": \"SELECT * FROM person WHERE job_company_website = 'posthog.com'\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getanyapi.com/v1/run/people_search.peopledatalabs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"limit\": 1,\n  \"sql\": \"SELECT * FROM person WHERE job_company_website = 'posthog.com'\"\n}"

response = http.request(request)
puts response.read_body

{
  "costUsd": 123,
  "items": 123,
  "output": {
    "data": {
      "people": [
        {
          "fullName": "<string>",
          "activityScore": "<string>",
          "available": {
            "birthDate": true,
            "birthYear": true,
            "facebookId": true,
            "facebookUrl": true,
            "facebookUsername": true,
            "githubUrl": true,
            "githubUsername": true,
            "locationAddressLine2": true,
            "locationStreetAddress": true,
            "mobilePhone": true,
            "personalEmails": true,
            "phoneNumbers": true,
            "recommendedPersonalEmail": true,
            "streetAddresses": true,
            "twitterUrl": true,
            "twitterUsername": true,
            "workEmail": true
          },
          "companyAddressLine2": "<string>",
          "companyContinent": "<string>",
          "companyFacebookUrl": "<string>",
          "companyFounded": 123,
          "companyGeo": "<string>",
          "companyId": "<string>",
          "companyIndustry": "<string>",
          "companyIndustryV2": "<string>",
          "companyLinkedinId": "<string>",
          "companyLinkedinUrl": "<string>",
          "companyLocality": "<string>",
          "companyLocationCountry": "<string>",
          "companyLocationName": "<string>",
          "companyMetro": "<string>",
          "companyName": "<string>",
          "companyPostalCode": "<string>",
          "companyRegion": "<string>",
          "companySize": "<string>",
          "companyStreetAddress": "<string>",
          "companyTwitterUrl": "<string>",
          "companyWebsite": "<string>",
          "continent": "<string>",
          "countries": [
            "<string>"
          ],
          "country": "<string>",
          "education": [
            {
              "degrees": [
                "<string>"
              ],
              "endDate": "<string>",
              "gpa": 123,
              "majors": [
                "<string>"
              ],
              "minors": [
                "<string>"
              ],
              "schoolName": "<string>",
              "schoolType": "<string>",
              "schoolWebsite": "<string>",
              "startDate": "<string>"
            }
          ],
          "emails": [
            {
              "type": "<string>"
            }
          ],
          "experience": [
            {
              "companyId": "<string>",
              "companyIndustry": "<string>",
              "companyLinkedinUrl": "<string>",
              "companyName": "<string>",
              "companySize": "<string>",
              "companyWebsite": "<string>",
              "endDate": "<string>",
              "isPrimary": true,
              "startDate": "<string>",
              "title": "<string>",
              "titleLevels": [
                "<string>"
              ],
              "titleRole": "<string>"
            }
          ],
          "firstName": "<string>",
          "geo": "<string>",
          "industry": "<string>",
          "interests": [
            "<string>"
          ],
          "jobChangedUtc": 123,
          "jobStartDate": "<string>",
          "jobTitle": "<string>",
          "jobTitleClass": "<string>",
          "jobTitleLevels": [
            "<string>"
          ],
          "jobTitleRole": "<string>",
          "jobTitleSubRole": "<string>",
          "jobVerifiedUtc": 123,
          "lastInitial": "<string>",
          "lastName": "<string>",
          "linkedinId": "<string>",
          "linkedinUrl": "<string>",
          "linkedinUsername": "<string>",
          "locality": "<string>",
          "locationName": "<string>",
          "locationNames": [
            "<string>"
          ],
          "locationUpdatedUtc": 123,
          "metro": "<string>",
          "middleInitial": "<string>",
          "middleName": "<string>",
          "pdlId": "<string>",
          "postalCode": "<string>",
          "profileScore": "<string>",
          "profiles": [
            {
              "network": "<string>"
            }
          ],
          "region": "<string>",
          "regions": [
            "<string>"
          ],
          "sex": "<string>",
          "skills": [
            "<string>"
          ]
        }
      ],
      "datasetVersion": "<string>",
      "total": 123
    },
    "found": true
  },
  "provider": "<string>",
  "replayed": true,
  "hint": "<string>",
  "jqError": "<string>",
  "resultId": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "error": "<string>",
  "code": "<string>",
  "payment": {
    "costUsd": 1,
    "rail": "<string>",
    "settlementState": "charged_undelivered"
  },
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization

string

header

default:YOUR_ANYAPI_KEY

required

Your AnyAPI key as a Bearer token.

Headers

Idempotency-Key

string

Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict.

Required string length: 1 - 255

Query Parameters

fields

string

Optional. Comma-separated keys (dotted paths like author.name descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the data/items envelope is unwrapped, not against the top-level response envelope, so use jq to reshape the whole envelope. Shrinks the response without changing cost.

max_items

integer

Optional. Cap the number of result rows returned; a _truncated note reports how many were withheld so you can page via the API's own limit. Does not change cost.

Required range: x >= 0

summary

boolean

Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.

string

Optional. A jq expression applied to the result envelope; its output replaces output (multiple outputs collect into an array). Reshape freely, e.g. jq=.data | {title, description, md: .markdown[:3500]}. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a jqError. Does not change cost.

Body

application/json

People Search - People Data Labs input
People Search - People Data Labs input

sql

string

required

People Data Labs SQL, in the form SELECT * FROM person WHERE ... . String literals take single quotes, only SELECT * is supported, and field names must be real People Data Labs person fields including nested subfields such as experience.title.name. Do not include a LIMIT clause; People Data Labs rejects it. Use limit instead. Send this or query, never both.

Minimum string length: 1

dataInclude

string

Comma-separated People Data Labs fields to include, or a leading - list to exclude. Projection changes the payload only; billing still follows profiles returned.

dataset

string

People Data Labs dataset to search, when your plan exposes more than one.

limit

integer

default:10

Maximum profiles to return. Every profile returned is billed, so start at 1 to check a query and read total before asking for more.

Required range: 1 <= x <= 59

preferLatencyUnderMs

integer

Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted.

Required range: x >= 1

query

object

Elasticsearch-style query over the People Data Labs person dataset, e.g. {"bool": {"must": [{"term": {"job_company_website": "posthog.com"}}]}}. Send this or sql, never both.

titlecase

boolean

Return text in title case instead of People Data Labs' lowercase default.

Response

Normalized result.

costUsd

number

required

USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free.

items

integer

required

Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count.

output

People Search - People Data Labs output · object | null

required

Normalized output, or null when the replay payload was not retained.

Hide child attributes

output.data

null | object

required

The matching profiles plus the total the query matched. People Data Labs paginates with a scroll token that is not exposed here, so a call returns one page and total tells you how much is behind it.

Hide child attributes

output.data.people

object[]

required

Matching person profiles, up to limit.

Hide child attributes

output.data.people.fullName

string

required

Person's full name.

output.data.people.activityScore

string

People Data Labs' qualitative score for how recently the profile showed activity.

output.data.people.available

object

What People Data Labs holds for this person but does not return in search. Each flag is true when Person Enrichment - People Data Labs would return that field for this profile.

Hide child attributes

output.data.people.available.birthDate

boolean

A birth date is available.

output.data.people.available.birthYear

boolean

A birth year is available.

output.data.people.available.facebookId

boolean

A Facebook numeric id is available.

output.data.people.available.facebookUrl

boolean

A Facebook profile URL is available.

output.data.people.available.facebookUsername

boolean

A Facebook handle is available.

output.data.people.available.githubUrl

boolean

A GitHub profile URL is available.

output.data.people.available.githubUsername

boolean

A GitHub handle is available.

output.data.people.available.locationAddressLine2

boolean

A second address line is available.

output.data.people.available.locationStreetAddress

boolean

The current street address is available.

output.data.people.available.mobilePhone

boolean

A mobile phone number is available.

output.data.people.available.personalEmails

boolean

Personal email addresses are available.

output.data.people.available.phoneNumbers

boolean

Phone numbers are available.

output.data.people.available.recommendedPersonalEmail

boolean

A recommended personal email address is available.

output.data.people.available.streetAddresses

boolean

Street addresses are available.

output.data.people.available.twitterUrl

boolean

An X (Twitter) profile URL is available.

output.data.people.available.twitterUsername

boolean

An X (Twitter) handle is available.

output.data.people.available.workEmail

boolean

A work email address is available.

output.data.people.companyAddressLine2

string

Second line of the current employer's headquarters address.

output.data.people.companyContinent

string

Current employer headquarters continent.

output.data.people.companyFacebookUrl

string<uri>

Current employer Facebook page URL.

output.data.people.companyFounded

integer

Year the current employer was founded.

output.data.people.companyGeo

string

Current employer headquarters coordinates as "lat,lon".

output.data.people.companyId

string

People Data Labs company id for the current employer.

output.data.people.companyIndustry

string

Current employer industry.

output.data.people.companyIndustryV2

string

Current employer industry on People Data Labs' newer taxonomy.

output.data.people.companyLinkedinId

string

Current employer LinkedIn numeric id.

output.data.people.companyLinkedinUrl

string<uri>

Current employer LinkedIn page URL.

output.data.people.companyLocality

string

Current employer headquarters city.

output.data.people.companyLocationCountry

string

Current employer headquarters country.

output.data.people.companyLocationName

string

Current employer headquarters as one display string.

output.data.people.companyMetro

string

Current employer headquarters metro area.

output.data.people.companyName

string

Current employer name.

output.data.people.companyPostalCode

string

Current employer headquarters postal code.

output.data.people.companyRegion

string

Current employer headquarters state or region.

output.data.people.companySize

string

Current employer headcount band.

output.data.people.companyStreetAddress

string

Current employer headquarters street address.

output.data.people.companyTwitterUrl

string<uri>

Current employer X (Twitter) profile URL.

output.data.people.companyWebsite

string

Current employer website domain.

output.data.people.continent

string

Continent.

output.data.people.countries

string[]

Every country associated with the person.

output.data.people.country

string

Country.

output.data.people.education

object[]

Education history.

Hide child attributes

output.data.people.education.degrees

string[]

Degrees earned.

output.data.people.education.endDate

string

When study ended.

output.data.people.education.gpa

number

Grade point average, when published.

output.data.people.education.majors

string[]

Majors studied.

output.data.people.education.minors

string[]

Minors studied.

output.data.people.education.schoolName

string

School name.

output.data.people.education.schoolType

string

School type.

output.data.people.education.schoolWebsite

string

School website domain.

output.data.people.education.startDate

string

When study started.

output.data.people.emails

object[]

One entry per email address People Data Labs holds for the person. Search returns the kind only; the address itself comes from Person Enrichment - People Data Labs.

Hide child attributes

output.data.people.emails.type

string

Address kind, e.g. professional or personal.

output.data.people.experience

object[]

Work history.

Hide child attributes

output.data.people.experience.companyId

string

People Data Labs company id for the employer.

output.data.people.experience.companyIndustry

string

Employer industry.

output.data.people.experience.companyLinkedinUrl

string<uri>

Employer LinkedIn page URL.

output.data.people.experience.companyName

string

Employer name.

output.data.people.experience.companySize

string

Employer headcount band.

output.data.people.experience.companyWebsite

string

Employer website domain.

output.data.people.experience.endDate

string

When the role ended, absent while the role is current.

output.data.people.experience.isPrimary

boolean

True for the role People Data Labs treats as current.

output.data.people.experience.startDate

string

When the role started: YYYY, YYYY-MM or YYYY-MM-DD.

output.data.people.experience.title

string

Job title held.

output.data.people.experience.titleLevels

string[]

Seniority levels for the title.

output.data.people.experience.titleRole

string

Normalized role for the title.

output.data.people.firstName

string

First name.

output.data.people.geo

string

Coordinates as "lat,lon".

output.data.people.industry

string

Industry the person works in.

output.data.people.interests

string[]

Interests the person lists.

output.data.people.jobChangedUtc

number

UTC epoch timestamp in seconds (Unix time) the person last changed jobs. Multiply by 1000 for a JS Date in milliseconds.

output.data.people.jobStartDate

string

When the current role started: YYYY, YYYY-MM or YYYY-MM-DD.

output.data.people.jobTitle

string

Current job title.

output.data.people.jobTitleClass

string

Normalized title class.

output.data.people.jobTitleLevels

string[]

Seniority levels for the current title.

output.data.people.jobTitleRole

string

Normalized role for the current title.

output.data.people.jobTitleSubRole

string

Normalized sub-role for the current title.

output.data.people.jobVerifiedUtc

number

UTC epoch timestamp in seconds (Unix time) the current role was last verified. Multiply by 1000 for a JS Date in milliseconds.

output.data.people.lastInitial

string

Last initial.

output.data.people.lastName

string

Last name.

output.data.people.linkedinId

string

LinkedIn numeric member id.

output.data.people.linkedinUrl

string<uri>

LinkedIn profile URL.

output.data.people.linkedinUsername

string

LinkedIn vanity handle.

output.data.people.locality

string

City.

output.data.people.locationName

string

Where the person lives, as one display string.

output.data.people.locationNames

string[]

Every location People Data Labs has associated with the person.

output.data.people.locationUpdatedUtc

number

UTC epoch timestamp in seconds (Unix time) the person's location was last updated. Multiply by 1000 for a JS Date in milliseconds.

output.data.people.metro

string

Metro area.

output.data.people.middleInitial

string

Middle initial.

output.data.people.middleName

string

Middle name.

output.data.people.pdlId

string

People Data Labs persistent person id. Send it to Person Enrichment - People Data Labs to re-pull this record.

output.data.people.postalCode

string

Postal code.

output.data.people.profileScore

string

People Data Labs' qualitative score for how complete the profile is.

output.data.people.profiles

object[]

Networks People Data Labs has a profile for. Search returns the network name only; profile URLs and handles come from Person Enrichment - People Data Labs.

Hide child attributes

output.data.people.profiles.network

string

required

Network name, e.g. linkedin, facebook, twitter.

output.data.people.region

string

State or region.

output.data.people.regions

string[]

Every region associated with the person.

output.data.people.sex

string

Sex recorded for the person.

output.data.people.skills

string[]

Skills the person lists.

output.data.datasetVersion

string

Version of the People Data Labs dataset these records came from.

output.data.total

integer

Profiles matching the query across the whole dataset, not just this page.

output.found

boolean

required

False when the query matched no profile.

provider

string

required

Always "AnyAPI".

replayed

boolean

required

True when this response replays the durable result of an earlier run without billing or upstream execution.

hint

string

Optional one-line nudge, absent when there is nothing to say. large_result: suggests the fields/max_items/summary/jq controls for a big response. paging_unavailable: means this result came from a source that cannot return a nextCursor, so it may be INCOMPLETE and cannot be continued - re-run with requireCursor: true to be served only by a source that can page, which may cost more per request.

jqError

string

Present only when a jq expression failed; output then carries the full unshaped result and this explains why the reshape did not apply.

resultId

string

Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache.

Getting Started

Sell on AnyAPI

API Reference

People Search - People Data Labs

Authorizations

Headers

Query Parameters

Body

Response