People Signals API

curl --request POST \
  --url https://api.cufinder.io/v3/signals/people \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "signal_name": "<string>",
  "time_frame": 123,
  "bucket": "<string>"
}
'

import requests

url = "https://api.cufinder.io/v3/signals/people"

payload = {
    "signal_name": "<string>",
    "time_frame": 123,
    "bucket": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({signal_name: '<string>', time_frame: 123, bucket: '<string>'})
};

fetch('https://api.cufinder.io/v3/signals/people', 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.cufinder.io/v3/signals/people",
  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([
    'signal_name' => '<string>',
    'time_frame' => 123,
    'bucket' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$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.cufinder.io/v3/signals/people"

	payload := strings.NewReader("{\n  \"signal_name\": \"<string>\",\n  \"time_frame\": 123,\n  \"bucket\": \"<string>\"\n}")

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

	req.Header.Add("x-api-key", "<api-key>")
	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.cufinder.io/v3/signals/people")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"signal_name\": \"<string>\",\n  \"time_frame\": 123,\n  \"bucket\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cufinder.io/v3/signals/people")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"signal_name\": \"<string>\",\n  \"time_frame\": 123,\n  \"bucket\": \"<string>\"\n}"

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

POST

signals

people

People Signals API

curl --request POST \
  --url https://api.cufinder.io/v3/signals/people \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "signal_name": "<string>",
  "time_frame": 123,
  "bucket": "<string>"
}
'

import requests

url = "https://api.cufinder.io/v3/signals/people"

payload = {
    "signal_name": "<string>",
    "time_frame": 123,
    "bucket": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({signal_name: '<string>', time_frame: 123, bucket: '<string>'})
};

fetch('https://api.cufinder.io/v3/signals/people', 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.cufinder.io/v3/signals/people",
  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([
    'signal_name' => '<string>',
    'time_frame' => 123,
    'bucket' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$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.cufinder.io/v3/signals/people"

	payload := strings.NewReader("{\n  \"signal_name\": \"<string>\",\n  \"time_frame\": 123,\n  \"bucket\": \"<string>\"\n}")

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

	req.Header.Add("x-api-key", "<api-key>")
	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.cufinder.io/v3/signals/people")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"signal_name\": \"<string>\",\n  \"time_frame\": 123,\n  \"bucket\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cufinder.io/v3/signals/people")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"signal_name\": \"<string>\",\n  \"time_frame\": 123,\n  \"bucket\": \"<string>\"\n}"

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

Common Use Cases

Turn any buying signal into a live list of the people at companies where it just fired.

Signal-Based Prospecting: Reaching people at companies hitting a chosen signal.
Timely Outreach: Contacting decision-makers while the signal is still fresh.
Territory Building: Pulling contacts by signal, strength, and recency.
Account Prioritization: Focusing on accounts showing the strongest signals.

Credit usage is 2 credits per request.

Attributes

string

required

The people buying signal to filter by. This endpoint uses the 17 People-category signals, such as employee_joined or c_suite_hire; company-level signals belong to the Company Signals API instead. See the full list below.

All available people signal names (17)

Signal name	What it detects
`c_suite_departure`	A C-level executive left the company.
`c_suite_hire`	A new C-level executive joined the company.
`employee_departed`	A person left this company for another.
`employee_joined`	A person’s current company changed to this company.
`engineering_leader_hire`	A new engineering leader joined the company.
`first_role_hire`	A company made its first-ever hire for a role function.
`founder_departure`	A founder left the company.
`internal_promotion`	Someone was promoted to a more senior title at the same company.
`key_role_vacancy`	A senior role stayed unfilled for 60 days.
`lateral_title_change`	Someone changed title at the same company without a seniority change.
`leadership_churn_spike`	Multiple senior leaders departed in a short window.
`notable_hire`	A high-profile or highly experienced person joined.
`sales_leader_hire`	A new sales leader joined the company.
`talent_inflow_from_company`	A company hired multiple people from the same source company.
`talent_outflow_to_competitor`	An employee left for a known competitor.
`vp_departure`	A VP-level leader left the company.
`vp_hire`	A new VP-level leader joined the company.

integer

required

Look-back window in days. Allowed values: 7, 30, 90, or 180.

string

required

Signal strength. Allowed values: low, moderate, high, or hyper.

integer

Page number for paginated results.

Response

{
    "success": true,
    "data": {
        "people": [
            {
                "first_name": null,
                "last_name": null,
                "full_name": "ann forslund",
                "avatar_url": null,
                "job": {
                    "title": "scientific director, translational medicine team lead, precision medicine and clinical biomarkers oncology",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "bristol myers squibb",
                    "domain": null,
                    "website_url": "http://www.bms.com",
                    "industry": "pharmaceutical manufacturing",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "new jersey",
                        "city": "lawrence township",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/bristol-myers-squibb",
                        "facebook_url": "facebook.com/bristolmyerssquibb",
                        "twitter_url": "twitter.com/bmsnews"
                    }
                },
                "location": {
                    "country": "united states",
                    "state": "new jersey",
                    "city": "princeton",
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/00001",
                    "facebook_url": null,
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "ahmed ahmed",
                "avatar_url": null,
                "job": {
                    "title": "senior operations specialist",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "marsh mclennan",
                    "domain": null,
                    "website_url": "http://www.corporate.marsh.com",
                    "industry": "professional services",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "new york",
                        "city": "new york",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/marshmclennan",
                        "facebook_url": "facebook.com/marsh-mclennan-companies-inc-250780238285607",
                        "twitter_url": "twitter.com/mmcbrm"
                    }
                },
                "location": {
                    "country": "poland",
                    "state": null,
                    "city": null,
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/079ahmed-ahmed",
                    "facebook_url": null,
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "brian oetken",
                "avatar_url": null,
                "job": {
                    "title": "vp",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "wells fargo",
                    "domain": null,
                    "website_url": "http://www.wellsfargo.com",
                    "industry": "financial services",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "california",
                        "city": "san francisco",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/wellsfargo",
                        "facebook_url": "facebook.com/wellsfargo/",
                        "twitter_url": "twitter.com/wellsfargo/"
                    }
                },
                "location": {
                    "country": "united states",
                    "state": "louisiana",
                    "city": "iowa",
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/0etkenb",
                    "facebook_url": "facebook.com/brian.oetken",
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "dharvinder singh",
                "avatar_url": null,
                "job": {
                    "title": "manager",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "bose corporation",
                    "domain": null,
                    "website_url": "http://www.bose.com",
                    "industry": "computers and electronics manufacturing",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "massachusetts",
                        "city": "framingham",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/bose-corporation",
                        "facebook_url": "facebook.com/bose",
                        "twitter_url": "twitter.com/bose"
                    }
                },
                "location": {
                    "country": "united states",
                    "state": "georgia",
                    "city": "atlanta",
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/100nu",
                    "facebook_url": null,
                    "twitter_url": "twitter.com/tweetsonu"
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "gary skarr",
                "avatar_url": null,
                "job": {
                    "title": "benefits director",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "rush university medical center",
                    "domain": null,
                    "website_url": "https://www.rush.edu",
                    "industry": "hospitals and health care",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "illinois",
                        "city": "chicago",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/rush-university-medical-center",
                        "facebook_url": "facebook.com/RushUniversity",
                        "twitter_url": "twitter.com/rushmedical"
                    }
                },
                "location": {
                    "country": "united states",
                    "state": "illinois",
                    "city": "naperville",
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/102753",
                    "facebook_url": "facebook.com/gary.skarr",
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "massimiliano pierantoni",
                "avatar_url": null,
                "job": {
                    "title": "gucci precious lg, specific mix and special event produc. control & procurement senior manager gucci–ww lg & shoe operations",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "gucci",
                    "domain": null,
                    "website_url": "https://careers.gucci.com",
                    "industry": "retail luxury goods and jewelry",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "italy",
                        "state": "florence",
                        "city": "casellina di scandicci",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/gucci",
                        "facebook_url": "facebook.com/gucci",
                        "twitter_url": "twitter.com/gucci"
                    }
                },
                "location": {
                    "country": "italy",
                    "state": null,
                    "city": null,
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/140967",
                    "facebook_url": null,
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "ca dipali gupta",
                "avatar_url": null,
                "job": {
                    "title": "specialist calypso | social ambassador",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "nasdaq",
                    "domain": null,
                    "website_url": "https://www.nasdaq.com",
                    "industry": "financial services",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "new york",
                        "city": "new york",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/nasdaq",
                        "facebook_url": "facebook.com/nasdaq/",
                        "twitter_url": "twitter.com/nasdaq"
                    }
                },
                "location": {
                    "country": "india",
                    "state": null,
                    "city": null,
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/1996-ca-dipali-gupta",
                    "facebook_url": null,
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "david rosca",
                "avatar_url": null,
                "job": {
                    "title": "software engineer",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "curtiss-wright corporation",
                    "domain": null,
                    "website_url": "https://curtisswright.com",
                    "industry": "defense and space manufacturing",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "north carolina",
                        "city": "davidson",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/curtiss-wright-corporation",
                        "facebook_url": "facebook.com/onecwcareers/",
                        "twitter_url": "twitter.com/curtisswright"
                    }
                },
                "location": {
                    "country": "united states",
                    "state": "california",
                    "city": "placentia",
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/1dave",
                    "facebook_url": "facebook.com/dave.rosca",
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "mandy dhaliwal",
                "avatar_url": null,
                "job": {
                    "title": "evp and cmo | board director",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "nutanix",
                    "domain": null,
                    "website_url": "http://www.nutanix.com",
                    "industry": "software development",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "california",
                        "city": "san jose",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/nutanix",
                        "facebook_url": "facebook.com/nutanix",
                        "twitter_url": "twitter.com/nutanix"
                    }
                },
                "location": {
                    "country": "united states",
                    "state": "california",
                    "city": "san jose",
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/1mandydhaliwal",
                    "facebook_url": null,
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            },
            {
                "first_name": null,
                "last_name": null,
                "full_name": "farida kafaei",
                "avatar_url": null,
                "job": {
                    "title": "compliance specialist",
                    "level": null,
                    "categories": []
                },
                "company": {
                    "name": "the estée lauder companies inc.",
                    "domain": null,
                    "website_url": "http://www.elcompanies.com",
                    "industry": "personal care product manufacturing",
                    "type": null,
                    "employee_range": null,
                    "followers_count": null,
                    "linkedin_id": null,
                    "logo_url": null,
                    "location": {
                        "country": "united states",
                        "state": "new york",
                        "city": "new york",
                        "address": null,
                        "postal_code": null
                    },
                    "social": {
                        "linkedin_url": "linkedin.com/company/the-estee-lauder-companies-inc",
                        "facebook_url": "facebook.com/elcompanies",
                        "twitter_url": "twitter.com/aveda"
                    }
                },
                "location": {
                    "country": "canada",
                    "state": "alberta",
                    "city": "calgary",
                    "address": null,
                    "postal_code": null
                },
                "social": {
                    "linkedin_url": "linkedin.com/in/200906",
                    "facebook_url": null,
                    "twitter_url": null
                },
                "signal": {
                    "name": "c_suite_hire",
                    "time_frame": 90,
                    "bucket": "hyper"
                }
            }
        ]
    },
    "meta": {
        "confidence": 96,
        "query": {
            "signal_name": "c_suite_hire",
            "time_frame": 90,
            "bucket": "hyper",
            "page": 1
        },
        "credits": {
            "charged": 2,
            "remaining": 9862
        },
        "pagination": {
            "page": 1,
            "has_more": true
        }
    }
}

Company Signals

Companies that just triggered a signal.

Job Changes

New jobs, promotions, and title moves.

Person Search

Search 1B+ profiles with combined filters.

Person Enrichment

Enrich a person with full contact data.

Get started

Signals APIs

Company Signals

People Signals

Composite Signals

People Signals API

Common Use Cases

Attributes

Response

Company Signals

Job Changes

Person Search

Person Enrichment

​Common Use Cases

​Attributes

​Response

​Related APIs

Company Signals

Job Changes

Person Search

Person Enrichment

Common Use Cases

Attributes

Response

Related APIs