People Search

People Search

curl --request POST \
  --url https://api.tuesday.so/api/v1/people/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "page": 123,
  "per_page": 123,
  "include_email": "<string>",
  "include_phone": "<string>",
  "person_titles": [
    "<string>"
  ],
  "person_not_titles": [
    "<string>"
  ],
  "person_past_titles": [
    "<string>"
  ],
  "person_seniorities": [
    "<string>"
  ],
  "person_location": [
    "<string>"
  ],
  "not_person_location": [
    "<string>"
  ],
  "person_days_in_current_title_range": {},
  "q_organization_domains": [
    "<string>"
  ],
  "not_q_organization_domains": [
    "<string>"
  ],
  "organization_location": [
    "<string>"
  ],
  "not_organization_location": [
    "<string>"
  ],
  "organization_industry": [
    "<string>"
  ],
  "organization_not_industry": [
    "<string>"
  ],
  "organization_sic_industry": [
    "<string>"
  ],
  "organization_not_sic_industry": [
    "<string>"
  ],
  "organization_naics_industry": [
    "<string>"
  ],
  "organization_not_naics_industry": [
    "<string>"
  ],
  "organization_revenue_ranges": [
    "<string>"
  ],
  "organization_technology": [
    "<string>"
  ],
  "organization_all_technology": [
    "<string>"
  ],
  "not_organization_technology": [
    "<string>"
  ],
  "organization_has_web_app": true,
  "organization_has_mobile_app": true,
  "organization_appstore_app_category": [
    "<string>"
  ],
  "organization_playstore_app_category": [
    "<string>"
  ],
  "organization_appstore_rating": {},
  "organization_playstore_rating": {},
  "organization_appstore_review_count": {},
  "organization_playstore_review_count": {},
  "organization_is_website_for_sale": true,
  "organization_website_traffic_total_monthly": {},
  "organization_website_traffic_monthly_organic": {},
  "organization_website_traffic_monthly_paid": {},
  "organization_monthly_google_adspend": {},
  "organization_funding_amount": {},
  "organization_funding_total_amount": {},
  "organization_funding_date": {},
  "organization_funding_type": [
    "<string>"
  ],
  "organization_funding_lead_investors": [
    "<string>"
  ],
  "organization_funding_number_of_investors": {},
  "organization_roles_count": [
    {}
  ],
  "organization_open_roles_count": [
    {}
  ]
}
'

import requests

url = "https://api.tuesday.so/api/v1/people/search"

payload = {
    "page": 123,
    "per_page": 123,
    "include_email": "<string>",
    "include_phone": "<string>",
    "person_titles": ["<string>"],
    "person_not_titles": ["<string>"],
    "person_past_titles": ["<string>"],
    "person_seniorities": ["<string>"],
    "person_location": ["<string>"],
    "not_person_location": ["<string>"],
    "person_days_in_current_title_range": {},
    "q_organization_domains": ["<string>"],
    "not_q_organization_domains": ["<string>"],
    "organization_location": ["<string>"],
    "not_organization_location": ["<string>"],
    "organization_industry": ["<string>"],
    "organization_not_industry": ["<string>"],
    "organization_sic_industry": ["<string>"],
    "organization_not_sic_industry": ["<string>"],
    "organization_naics_industry": ["<string>"],
    "organization_not_naics_industry": ["<string>"],
    "organization_revenue_ranges": ["<string>"],
    "organization_technology": ["<string>"],
    "organization_all_technology": ["<string>"],
    "not_organization_technology": ["<string>"],
    "organization_has_web_app": True,
    "organization_has_mobile_app": True,
    "organization_appstore_app_category": ["<string>"],
    "organization_playstore_app_category": ["<string>"],
    "organization_appstore_rating": {},
    "organization_playstore_rating": {},
    "organization_appstore_review_count": {},
    "organization_playstore_review_count": {},
    "organization_is_website_for_sale": True,
    "organization_website_traffic_total_monthly": {},
    "organization_website_traffic_monthly_organic": {},
    "organization_website_traffic_monthly_paid": {},
    "organization_monthly_google_adspend": {},
    "organization_funding_amount": {},
    "organization_funding_total_amount": {},
    "organization_funding_date": {},
    "organization_funding_type": ["<string>"],
    "organization_funding_lead_investors": ["<string>"],
    "organization_funding_number_of_investors": {},
    "organization_roles_count": [{}],
    "organization_open_roles_count": [{}]
}
headers = {
    "X-API-KEY": "<x-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': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    per_page: 123,
    include_email: '<string>',
    include_phone: '<string>',
    person_titles: ['<string>'],
    person_not_titles: ['<string>'],
    person_past_titles: ['<string>'],
    person_seniorities: ['<string>'],
    person_location: ['<string>'],
    not_person_location: ['<string>'],
    person_days_in_current_title_range: {},
    q_organization_domains: ['<string>'],
    not_q_organization_domains: ['<string>'],
    organization_location: ['<string>'],
    not_organization_location: ['<string>'],
    organization_industry: ['<string>'],
    organization_not_industry: ['<string>'],
    organization_sic_industry: ['<string>'],
    organization_not_sic_industry: ['<string>'],
    organization_naics_industry: ['<string>'],
    organization_not_naics_industry: ['<string>'],
    organization_revenue_ranges: ['<string>'],
    organization_technology: ['<string>'],
    organization_all_technology: ['<string>'],
    not_organization_technology: ['<string>'],
    organization_has_web_app: true,
    organization_has_mobile_app: true,
    organization_appstore_app_category: ['<string>'],
    organization_playstore_app_category: ['<string>'],
    organization_appstore_rating: {},
    organization_playstore_rating: {},
    organization_appstore_review_count: {},
    organization_playstore_review_count: {},
    organization_is_website_for_sale: true,
    organization_website_traffic_total_monthly: {},
    organization_website_traffic_monthly_organic: {},
    organization_website_traffic_monthly_paid: {},
    organization_monthly_google_adspend: {},
    organization_funding_amount: {},
    organization_funding_total_amount: {},
    organization_funding_date: {},
    organization_funding_type: ['<string>'],
    organization_funding_lead_investors: ['<string>'],
    organization_funding_number_of_investors: {},
    organization_roles_count: [{}],
    organization_open_roles_count: [{}]
  })
};

fetch('https://api.tuesday.so/api/v1/people/search', 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.tuesday.so/api/v1/people/search",
  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([
    'page' => 123,
    'per_page' => 123,
    'include_email' => '<string>',
    'include_phone' => '<string>',
    'person_titles' => [
        '<string>'
    ],
    'person_not_titles' => [
        '<string>'
    ],
    'person_past_titles' => [
        '<string>'
    ],
    'person_seniorities' => [
        '<string>'
    ],
    'person_location' => [
        '<string>'
    ],
    'not_person_location' => [
        '<string>'
    ],
    'person_days_in_current_title_range' => [
        
    ],
    'q_organization_domains' => [
        '<string>'
    ],
    'not_q_organization_domains' => [
        '<string>'
    ],
    'organization_location' => [
        '<string>'
    ],
    'not_organization_location' => [
        '<string>'
    ],
    'organization_industry' => [
        '<string>'
    ],
    'organization_not_industry' => [
        '<string>'
    ],
    'organization_sic_industry' => [
        '<string>'
    ],
    'organization_not_sic_industry' => [
        '<string>'
    ],
    'organization_naics_industry' => [
        '<string>'
    ],
    'organization_not_naics_industry' => [
        '<string>'
    ],
    'organization_revenue_ranges' => [
        '<string>'
    ],
    'organization_technology' => [
        '<string>'
    ],
    'organization_all_technology' => [
        '<string>'
    ],
    'not_organization_technology' => [
        '<string>'
    ],
    'organization_has_web_app' => true,
    'organization_has_mobile_app' => true,
    'organization_appstore_app_category' => [
        '<string>'
    ],
    'organization_playstore_app_category' => [
        '<string>'
    ],
    'organization_appstore_rating' => [
        
    ],
    'organization_playstore_rating' => [
        
    ],
    'organization_appstore_review_count' => [
        
    ],
    'organization_playstore_review_count' => [
        
    ],
    'organization_is_website_for_sale' => true,
    'organization_website_traffic_total_monthly' => [
        
    ],
    'organization_website_traffic_monthly_organic' => [
        
    ],
    'organization_website_traffic_monthly_paid' => [
        
    ],
    'organization_monthly_google_adspend' => [
        
    ],
    'organization_funding_amount' => [
        
    ],
    'organization_funding_total_amount' => [
        
    ],
    'organization_funding_date' => [
        
    ],
    'organization_funding_type' => [
        '<string>'
    ],
    'organization_funding_lead_investors' => [
        '<string>'
    ],
    'organization_funding_number_of_investors' => [
        
    ],
    'organization_roles_count' => [
        [
                
        ]
    ],
    'organization_open_roles_count' => [
        [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <x-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.tuesday.so/api/v1/people/search"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"per_page\": 123,\n  \"include_email\": \"<string>\",\n  \"include_phone\": \"<string>\",\n  \"person_titles\": [\n    \"<string>\"\n  ],\n  \"person_not_titles\": [\n    \"<string>\"\n  ],\n  \"person_past_titles\": [\n    \"<string>\"\n  ],\n  \"person_seniorities\": [\n    \"<string>\"\n  ],\n  \"person_location\": [\n    \"<string>\"\n  ],\n  \"not_person_location\": [\n    \"<string>\"\n  ],\n  \"person_days_in_current_title_range\": {},\n  \"q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"not_q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"organization_location\": [\n    \"<string>\"\n  ],\n  \"not_organization_location\": [\n    \"<string>\"\n  ],\n  \"organization_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_industry\": [\n    \"<string>\"\n  ],\n  \"organization_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_revenue_ranges\": [\n    \"<string>\"\n  ],\n  \"organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_all_technology\": [\n    \"<string>\"\n  ],\n  \"not_organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_has_web_app\": true,\n  \"organization_has_mobile_app\": true,\n  \"organization_appstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_playstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_appstore_rating\": {},\n  \"organization_playstore_rating\": {},\n  \"organization_appstore_review_count\": {},\n  \"organization_playstore_review_count\": {},\n  \"organization_is_website_for_sale\": true,\n  \"organization_website_traffic_total_monthly\": {},\n  \"organization_website_traffic_monthly_organic\": {},\n  \"organization_website_traffic_monthly_paid\": {},\n  \"organization_monthly_google_adspend\": {},\n  \"organization_funding_amount\": {},\n  \"organization_funding_total_amount\": {},\n  \"organization_funding_date\": {},\n  \"organization_funding_type\": [\n    \"<string>\"\n  ],\n  \"organization_funding_lead_investors\": [\n    \"<string>\"\n  ],\n  \"organization_funding_number_of_investors\": {},\n  \"organization_roles_count\": [\n    {}\n  ],\n  \"organization_open_roles_count\": [\n    {}\n  ]\n}")

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

	req.Header.Add("X-API-KEY", "<x-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.tuesday.so/api/v1/people/search")
  .header("X-API-KEY", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"per_page\": 123,\n  \"include_email\": \"<string>\",\n  \"include_phone\": \"<string>\",\n  \"person_titles\": [\n    \"<string>\"\n  ],\n  \"person_not_titles\": [\n    \"<string>\"\n  ],\n  \"person_past_titles\": [\n    \"<string>\"\n  ],\n  \"person_seniorities\": [\n    \"<string>\"\n  ],\n  \"person_location\": [\n    \"<string>\"\n  ],\n  \"not_person_location\": [\n    \"<string>\"\n  ],\n  \"person_days_in_current_title_range\": {},\n  \"q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"not_q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"organization_location\": [\n    \"<string>\"\n  ],\n  \"not_organization_location\": [\n    \"<string>\"\n  ],\n  \"organization_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_industry\": [\n    \"<string>\"\n  ],\n  \"organization_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_revenue_ranges\": [\n    \"<string>\"\n  ],\n  \"organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_all_technology\": [\n    \"<string>\"\n  ],\n  \"not_organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_has_web_app\": true,\n  \"organization_has_mobile_app\": true,\n  \"organization_appstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_playstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_appstore_rating\": {},\n  \"organization_playstore_rating\": {},\n  \"organization_appstore_review_count\": {},\n  \"organization_playstore_review_count\": {},\n  \"organization_is_website_for_sale\": true,\n  \"organization_website_traffic_total_monthly\": {},\n  \"organization_website_traffic_monthly_organic\": {},\n  \"organization_website_traffic_monthly_paid\": {},\n  \"organization_monthly_google_adspend\": {},\n  \"organization_funding_amount\": {},\n  \"organization_funding_total_amount\": {},\n  \"organization_funding_date\": {},\n  \"organization_funding_type\": [\n    \"<string>\"\n  ],\n  \"organization_funding_lead_investors\": [\n    \"<string>\"\n  ],\n  \"organization_funding_number_of_investors\": {},\n  \"organization_roles_count\": [\n    {}\n  ],\n  \"organization_open_roles_count\": [\n    {}\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tuesday.so/api/v1/people/search")

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

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"per_page\": 123,\n  \"include_email\": \"<string>\",\n  \"include_phone\": \"<string>\",\n  \"person_titles\": [\n    \"<string>\"\n  ],\n  \"person_not_titles\": [\n    \"<string>\"\n  ],\n  \"person_past_titles\": [\n    \"<string>\"\n  ],\n  \"person_seniorities\": [\n    \"<string>\"\n  ],\n  \"person_location\": [\n    \"<string>\"\n  ],\n  \"not_person_location\": [\n    \"<string>\"\n  ],\n  \"person_days_in_current_title_range\": {},\n  \"q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"not_q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"organization_location\": [\n    \"<string>\"\n  ],\n  \"not_organization_location\": [\n    \"<string>\"\n  ],\n  \"organization_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_industry\": [\n    \"<string>\"\n  ],\n  \"organization_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_revenue_ranges\": [\n    \"<string>\"\n  ],\n  \"organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_all_technology\": [\n    \"<string>\"\n  ],\n  \"not_organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_has_web_app\": true,\n  \"organization_has_mobile_app\": true,\n  \"organization_appstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_playstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_appstore_rating\": {},\n  \"organization_playstore_rating\": {},\n  \"organization_appstore_review_count\": {},\n  \"organization_playstore_review_count\": {},\n  \"organization_is_website_for_sale\": true,\n  \"organization_website_traffic_total_monthly\": {},\n  \"organization_website_traffic_monthly_organic\": {},\n  \"organization_website_traffic_monthly_paid\": {},\n  \"organization_monthly_google_adspend\": {},\n  \"organization_funding_amount\": {},\n  \"organization_funding_total_amount\": {},\n  \"organization_funding_date\": {},\n  \"organization_funding_type\": [\n    \"<string>\"\n  ],\n  \"organization_funding_lead_investors\": [\n    \"<string>\"\n  ],\n  \"organization_funding_number_of_investors\": {},\n  \"organization_roles_count\": [\n    {}\n  ],\n  \"organization_open_roles_count\": [\n    {}\n  ]\n}"

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

{
    "data": [
        {
            "city": "Washington",
            "country": "United States",
            "country_code": "US",
            "country_region": "NORAM",
            "email": "austin.gerner@actif.ai",
            "first_name": "Austin",
            "id": "tu_pac5zsepm",
            "job_start_date": "2022-03-01",
            "last_name": "Gerner",
            "linkedin_url": "https://www.linkedin.com/in/austin-gerner-080413b4",
            "mobile_number": "+1 570-872-7952",
            "name": "Austin Gerner",
            "organization_id": "tu_oabfyglnu",
            "organizations.founded_year": 2019,
            "organizations.linkedin_url": "https://www.linkedin.com/company/actifai",
            "organizations.name": "Actifai",
            "organizations.primary_domain": "actif.ai",
            "organizations.website_url": "https://www.actif.ai",
            "seniority": "Staff",
            "state": "District of Columbia",
            "title": "Senior Software Engineer"
        },
        {
            "city": "Greenfield",
            "country": "United States",
            "country_code": "US",
            "country_region": "NORAM",
            "email": "phil.wingham@rtx.com",
            "first_name": "Phil",
            "id": "tu_pab5rkwdc",
            "job_start_date": "2012-01-01",
            "last_name": "Wingham",
            "linkedin_url": "https://www.linkedin.com/in/phil-wingham-697200b",
            "mobile_number": "+1 765-994-1888",
            "name": "Phil Wingham",
            "organization_id": "tu_oabstv4wl",
            "organizations.linkedin_url": "https://www.linkedin.com/company/rtx",
            "organizations.name": "Rtx",
            "organizations.primary_domain": "rtx.com",
            "organizations.website_url": "https://www.rtx.com",
            "seniority": "Staff",
            "state": "Indiana",
            "title": "Senior Software Engineer Ii"
        }
    ],
    "statusCode": 201,
    "message": "Success"
}

POST

api

people

People Search

curl --request POST \
  --url https://api.tuesday.so/api/v1/people/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "page": 123,
  "per_page": 123,
  "include_email": "<string>",
  "include_phone": "<string>",
  "person_titles": [
    "<string>"
  ],
  "person_not_titles": [
    "<string>"
  ],
  "person_past_titles": [
    "<string>"
  ],
  "person_seniorities": [
    "<string>"
  ],
  "person_location": [
    "<string>"
  ],
  "not_person_location": [
    "<string>"
  ],
  "person_days_in_current_title_range": {},
  "q_organization_domains": [
    "<string>"
  ],
  "not_q_organization_domains": [
    "<string>"
  ],
  "organization_location": [
    "<string>"
  ],
  "not_organization_location": [
    "<string>"
  ],
  "organization_industry": [
    "<string>"
  ],
  "organization_not_industry": [
    "<string>"
  ],
  "organization_sic_industry": [
    "<string>"
  ],
  "organization_not_sic_industry": [
    "<string>"
  ],
  "organization_naics_industry": [
    "<string>"
  ],
  "organization_not_naics_industry": [
    "<string>"
  ],
  "organization_revenue_ranges": [
    "<string>"
  ],
  "organization_technology": [
    "<string>"
  ],
  "organization_all_technology": [
    "<string>"
  ],
  "not_organization_technology": [
    "<string>"
  ],
  "organization_has_web_app": true,
  "organization_has_mobile_app": true,
  "organization_appstore_app_category": [
    "<string>"
  ],
  "organization_playstore_app_category": [
    "<string>"
  ],
  "organization_appstore_rating": {},
  "organization_playstore_rating": {},
  "organization_appstore_review_count": {},
  "organization_playstore_review_count": {},
  "organization_is_website_for_sale": true,
  "organization_website_traffic_total_monthly": {},
  "organization_website_traffic_monthly_organic": {},
  "organization_website_traffic_monthly_paid": {},
  "organization_monthly_google_adspend": {},
  "organization_funding_amount": {},
  "organization_funding_total_amount": {},
  "organization_funding_date": {},
  "organization_funding_type": [
    "<string>"
  ],
  "organization_funding_lead_investors": [
    "<string>"
  ],
  "organization_funding_number_of_investors": {},
  "organization_roles_count": [
    {}
  ],
  "organization_open_roles_count": [
    {}
  ]
}
'

import requests

url = "https://api.tuesday.so/api/v1/people/search"

payload = {
    "page": 123,
    "per_page": 123,
    "include_email": "<string>",
    "include_phone": "<string>",
    "person_titles": ["<string>"],
    "person_not_titles": ["<string>"],
    "person_past_titles": ["<string>"],
    "person_seniorities": ["<string>"],
    "person_location": ["<string>"],
    "not_person_location": ["<string>"],
    "person_days_in_current_title_range": {},
    "q_organization_domains": ["<string>"],
    "not_q_organization_domains": ["<string>"],
    "organization_location": ["<string>"],
    "not_organization_location": ["<string>"],
    "organization_industry": ["<string>"],
    "organization_not_industry": ["<string>"],
    "organization_sic_industry": ["<string>"],
    "organization_not_sic_industry": ["<string>"],
    "organization_naics_industry": ["<string>"],
    "organization_not_naics_industry": ["<string>"],
    "organization_revenue_ranges": ["<string>"],
    "organization_technology": ["<string>"],
    "organization_all_technology": ["<string>"],
    "not_organization_technology": ["<string>"],
    "organization_has_web_app": True,
    "organization_has_mobile_app": True,
    "organization_appstore_app_category": ["<string>"],
    "organization_playstore_app_category": ["<string>"],
    "organization_appstore_rating": {},
    "organization_playstore_rating": {},
    "organization_appstore_review_count": {},
    "organization_playstore_review_count": {},
    "organization_is_website_for_sale": True,
    "organization_website_traffic_total_monthly": {},
    "organization_website_traffic_monthly_organic": {},
    "organization_website_traffic_monthly_paid": {},
    "organization_monthly_google_adspend": {},
    "organization_funding_amount": {},
    "organization_funding_total_amount": {},
    "organization_funding_date": {},
    "organization_funding_type": ["<string>"],
    "organization_funding_lead_investors": ["<string>"],
    "organization_funding_number_of_investors": {},
    "organization_roles_count": [{}],
    "organization_open_roles_count": [{}]
}
headers = {
    "X-API-KEY": "<x-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': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    page: 123,
    per_page: 123,
    include_email: '<string>',
    include_phone: '<string>',
    person_titles: ['<string>'],
    person_not_titles: ['<string>'],
    person_past_titles: ['<string>'],
    person_seniorities: ['<string>'],
    person_location: ['<string>'],
    not_person_location: ['<string>'],
    person_days_in_current_title_range: {},
    q_organization_domains: ['<string>'],
    not_q_organization_domains: ['<string>'],
    organization_location: ['<string>'],
    not_organization_location: ['<string>'],
    organization_industry: ['<string>'],
    organization_not_industry: ['<string>'],
    organization_sic_industry: ['<string>'],
    organization_not_sic_industry: ['<string>'],
    organization_naics_industry: ['<string>'],
    organization_not_naics_industry: ['<string>'],
    organization_revenue_ranges: ['<string>'],
    organization_technology: ['<string>'],
    organization_all_technology: ['<string>'],
    not_organization_technology: ['<string>'],
    organization_has_web_app: true,
    organization_has_mobile_app: true,
    organization_appstore_app_category: ['<string>'],
    organization_playstore_app_category: ['<string>'],
    organization_appstore_rating: {},
    organization_playstore_rating: {},
    organization_appstore_review_count: {},
    organization_playstore_review_count: {},
    organization_is_website_for_sale: true,
    organization_website_traffic_total_monthly: {},
    organization_website_traffic_monthly_organic: {},
    organization_website_traffic_monthly_paid: {},
    organization_monthly_google_adspend: {},
    organization_funding_amount: {},
    organization_funding_total_amount: {},
    organization_funding_date: {},
    organization_funding_type: ['<string>'],
    organization_funding_lead_investors: ['<string>'],
    organization_funding_number_of_investors: {},
    organization_roles_count: [{}],
    organization_open_roles_count: [{}]
  })
};

fetch('https://api.tuesday.so/api/v1/people/search', 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.tuesday.so/api/v1/people/search",
  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([
    'page' => 123,
    'per_page' => 123,
    'include_email' => '<string>',
    'include_phone' => '<string>',
    'person_titles' => [
        '<string>'
    ],
    'person_not_titles' => [
        '<string>'
    ],
    'person_past_titles' => [
        '<string>'
    ],
    'person_seniorities' => [
        '<string>'
    ],
    'person_location' => [
        '<string>'
    ],
    'not_person_location' => [
        '<string>'
    ],
    'person_days_in_current_title_range' => [
        
    ],
    'q_organization_domains' => [
        '<string>'
    ],
    'not_q_organization_domains' => [
        '<string>'
    ],
    'organization_location' => [
        '<string>'
    ],
    'not_organization_location' => [
        '<string>'
    ],
    'organization_industry' => [
        '<string>'
    ],
    'organization_not_industry' => [
        '<string>'
    ],
    'organization_sic_industry' => [
        '<string>'
    ],
    'organization_not_sic_industry' => [
        '<string>'
    ],
    'organization_naics_industry' => [
        '<string>'
    ],
    'organization_not_naics_industry' => [
        '<string>'
    ],
    'organization_revenue_ranges' => [
        '<string>'
    ],
    'organization_technology' => [
        '<string>'
    ],
    'organization_all_technology' => [
        '<string>'
    ],
    'not_organization_technology' => [
        '<string>'
    ],
    'organization_has_web_app' => true,
    'organization_has_mobile_app' => true,
    'organization_appstore_app_category' => [
        '<string>'
    ],
    'organization_playstore_app_category' => [
        '<string>'
    ],
    'organization_appstore_rating' => [
        
    ],
    'organization_playstore_rating' => [
        
    ],
    'organization_appstore_review_count' => [
        
    ],
    'organization_playstore_review_count' => [
        
    ],
    'organization_is_website_for_sale' => true,
    'organization_website_traffic_total_monthly' => [
        
    ],
    'organization_website_traffic_monthly_organic' => [
        
    ],
    'organization_website_traffic_monthly_paid' => [
        
    ],
    'organization_monthly_google_adspend' => [
        
    ],
    'organization_funding_amount' => [
        
    ],
    'organization_funding_total_amount' => [
        
    ],
    'organization_funding_date' => [
        
    ],
    'organization_funding_type' => [
        '<string>'
    ],
    'organization_funding_lead_investors' => [
        '<string>'
    ],
    'organization_funding_number_of_investors' => [
        
    ],
    'organization_roles_count' => [
        [
                
        ]
    ],
    'organization_open_roles_count' => [
        [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <x-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.tuesday.so/api/v1/people/search"

	payload := strings.NewReader("{\n  \"page\": 123,\n  \"per_page\": 123,\n  \"include_email\": \"<string>\",\n  \"include_phone\": \"<string>\",\n  \"person_titles\": [\n    \"<string>\"\n  ],\n  \"person_not_titles\": [\n    \"<string>\"\n  ],\n  \"person_past_titles\": [\n    \"<string>\"\n  ],\n  \"person_seniorities\": [\n    \"<string>\"\n  ],\n  \"person_location\": [\n    \"<string>\"\n  ],\n  \"not_person_location\": [\n    \"<string>\"\n  ],\n  \"person_days_in_current_title_range\": {},\n  \"q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"not_q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"organization_location\": [\n    \"<string>\"\n  ],\n  \"not_organization_location\": [\n    \"<string>\"\n  ],\n  \"organization_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_industry\": [\n    \"<string>\"\n  ],\n  \"organization_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_revenue_ranges\": [\n    \"<string>\"\n  ],\n  \"organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_all_technology\": [\n    \"<string>\"\n  ],\n  \"not_organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_has_web_app\": true,\n  \"organization_has_mobile_app\": true,\n  \"organization_appstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_playstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_appstore_rating\": {},\n  \"organization_playstore_rating\": {},\n  \"organization_appstore_review_count\": {},\n  \"organization_playstore_review_count\": {},\n  \"organization_is_website_for_sale\": true,\n  \"organization_website_traffic_total_monthly\": {},\n  \"organization_website_traffic_monthly_organic\": {},\n  \"organization_website_traffic_monthly_paid\": {},\n  \"organization_monthly_google_adspend\": {},\n  \"organization_funding_amount\": {},\n  \"organization_funding_total_amount\": {},\n  \"organization_funding_date\": {},\n  \"organization_funding_type\": [\n    \"<string>\"\n  ],\n  \"organization_funding_lead_investors\": [\n    \"<string>\"\n  ],\n  \"organization_funding_number_of_investors\": {},\n  \"organization_roles_count\": [\n    {}\n  ],\n  \"organization_open_roles_count\": [\n    {}\n  ]\n}")

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

	req.Header.Add("X-API-KEY", "<x-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.tuesday.so/api/v1/people/search")
  .header("X-API-KEY", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"page\": 123,\n  \"per_page\": 123,\n  \"include_email\": \"<string>\",\n  \"include_phone\": \"<string>\",\n  \"person_titles\": [\n    \"<string>\"\n  ],\n  \"person_not_titles\": [\n    \"<string>\"\n  ],\n  \"person_past_titles\": [\n    \"<string>\"\n  ],\n  \"person_seniorities\": [\n    \"<string>\"\n  ],\n  \"person_location\": [\n    \"<string>\"\n  ],\n  \"not_person_location\": [\n    \"<string>\"\n  ],\n  \"person_days_in_current_title_range\": {},\n  \"q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"not_q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"organization_location\": [\n    \"<string>\"\n  ],\n  \"not_organization_location\": [\n    \"<string>\"\n  ],\n  \"organization_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_industry\": [\n    \"<string>\"\n  ],\n  \"organization_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_revenue_ranges\": [\n    \"<string>\"\n  ],\n  \"organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_all_technology\": [\n    \"<string>\"\n  ],\n  \"not_organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_has_web_app\": true,\n  \"organization_has_mobile_app\": true,\n  \"organization_appstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_playstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_appstore_rating\": {},\n  \"organization_playstore_rating\": {},\n  \"organization_appstore_review_count\": {},\n  \"organization_playstore_review_count\": {},\n  \"organization_is_website_for_sale\": true,\n  \"organization_website_traffic_total_monthly\": {},\n  \"organization_website_traffic_monthly_organic\": {},\n  \"organization_website_traffic_monthly_paid\": {},\n  \"organization_monthly_google_adspend\": {},\n  \"organization_funding_amount\": {},\n  \"organization_funding_total_amount\": {},\n  \"organization_funding_date\": {},\n  \"organization_funding_type\": [\n    \"<string>\"\n  ],\n  \"organization_funding_lead_investors\": [\n    \"<string>\"\n  ],\n  \"organization_funding_number_of_investors\": {},\n  \"organization_roles_count\": [\n    {}\n  ],\n  \"organization_open_roles_count\": [\n    {}\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tuesday.so/api/v1/people/search")

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

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"page\": 123,\n  \"per_page\": 123,\n  \"include_email\": \"<string>\",\n  \"include_phone\": \"<string>\",\n  \"person_titles\": [\n    \"<string>\"\n  ],\n  \"person_not_titles\": [\n    \"<string>\"\n  ],\n  \"person_past_titles\": [\n    \"<string>\"\n  ],\n  \"person_seniorities\": [\n    \"<string>\"\n  ],\n  \"person_location\": [\n    \"<string>\"\n  ],\n  \"not_person_location\": [\n    \"<string>\"\n  ],\n  \"person_days_in_current_title_range\": {},\n  \"q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"not_q_organization_domains\": [\n    \"<string>\"\n  ],\n  \"organization_location\": [\n    \"<string>\"\n  ],\n  \"not_organization_location\": [\n    \"<string>\"\n  ],\n  \"organization_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_industry\": [\n    \"<string>\"\n  ],\n  \"organization_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_sic_industry\": [\n    \"<string>\"\n  ],\n  \"organization_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_not_naics_industry\": [\n    \"<string>\"\n  ],\n  \"organization_revenue_ranges\": [\n    \"<string>\"\n  ],\n  \"organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_all_technology\": [\n    \"<string>\"\n  ],\n  \"not_organization_technology\": [\n    \"<string>\"\n  ],\n  \"organization_has_web_app\": true,\n  \"organization_has_mobile_app\": true,\n  \"organization_appstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_playstore_app_category\": [\n    \"<string>\"\n  ],\n  \"organization_appstore_rating\": {},\n  \"organization_playstore_rating\": {},\n  \"organization_appstore_review_count\": {},\n  \"organization_playstore_review_count\": {},\n  \"organization_is_website_for_sale\": true,\n  \"organization_website_traffic_total_monthly\": {},\n  \"organization_website_traffic_monthly_organic\": {},\n  \"organization_website_traffic_monthly_paid\": {},\n  \"organization_monthly_google_adspend\": {},\n  \"organization_funding_amount\": {},\n  \"organization_funding_total_amount\": {},\n  \"organization_funding_date\": {},\n  \"organization_funding_type\": [\n    \"<string>\"\n  ],\n  \"organization_funding_lead_investors\": [\n    \"<string>\"\n  ],\n  \"organization_funding_number_of_investors\": {},\n  \"organization_roles_count\": [\n    {}\n  ],\n  \"organization_open_roles_count\": [\n    {}\n  ]\n}"

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

{
    "data": [
        {
            "city": "Washington",
            "country": "United States",
            "country_code": "US",
            "country_region": "NORAM",
            "email": "austin.gerner@actif.ai",
            "first_name": "Austin",
            "id": "tu_pac5zsepm",
            "job_start_date": "2022-03-01",
            "last_name": "Gerner",
            "linkedin_url": "https://www.linkedin.com/in/austin-gerner-080413b4",
            "mobile_number": "+1 570-872-7952",
            "name": "Austin Gerner",
            "organization_id": "tu_oabfyglnu",
            "organizations.founded_year": 2019,
            "organizations.linkedin_url": "https://www.linkedin.com/company/actifai",
            "organizations.name": "Actifai",
            "organizations.primary_domain": "actif.ai",
            "organizations.website_url": "https://www.actif.ai",
            "seniority": "Staff",
            "state": "District of Columbia",
            "title": "Senior Software Engineer"
        },
        {
            "city": "Greenfield",
            "country": "United States",
            "country_code": "US",
            "country_region": "NORAM",
            "email": "phil.wingham@rtx.com",
            "first_name": "Phil",
            "id": "tu_pab5rkwdc",
            "job_start_date": "2012-01-01",
            "last_name": "Wingham",
            "linkedin_url": "https://www.linkedin.com/in/phil-wingham-697200b",
            "mobile_number": "+1 765-994-1888",
            "name": "Phil Wingham",
            "organization_id": "tu_oabstv4wl",
            "organizations.linkedin_url": "https://www.linkedin.com/company/rtx",
            "organizations.name": "Rtx",
            "organizations.primary_domain": "rtx.com",
            "organizations.website_url": "https://www.rtx.com",
            "seniority": "Staff",
            "state": "Indiana",
            "title": "Senior Software Engineer Ii"
        }
    ],
    "statusCode": 201,
    "message": "Success"
}

Overview

Search for people using advanced filters and criteria. This endpoint allows you to find professionals based on combinations of title, company, location, seniority, and other attributes. Perfect for building targeted prospect lists and conducting market research.

Authentication

string

required

Your Tuesday API key

Request Parameters

All parameters are optional. Combine them to filter results precisely.

📄 Pagination

int

default:"1"

Page number

int

default:"25"

Results per page (max: 100)

string

default:"exclude"

Include email addressOptions: include | excludeAdditional Cost: +2 credits per result when set to include

string

default:"exclude"

Include phone numberOptions: include | excludeAdditional Cost: +3 credits per result when set to include

👤 Person Filters

string[]

Current job titles to includeExamples: ["Software Engineer", "Senior Developer"]

string[]

Exclude these current job titles

string[]

Match against past job titles

string[]

Filter by seniority levelExamples: ["C-Team", "Manager", "Director"]

string[]

Current person locationExamples: ["San Francisco", "California", "United States"]

string[]

Exclude people in these locations

object

Days in current role/titleFormat: {"min": 30, "max": 300}

🏢 Organization Filters

string[]

Match organization domainsExamples: ["google.com", "microsoft.com"]

string[]

Exclude organizations with these domains

string[]

Company HQ/location

string[]

Exclude companies in these locations

string[]

Include companies in these industriesExamples: ["Technology", "Healthcare", "Finance"]

string[]

Exclude companies from these industries

string[]

Filter by SIC codesExamples: ["0919"]

string[]

Exclude SIC codes

string[]

Filter by NAICS codesExamples: ["236117"]

string[]

Exclude NAICS codes

string[]

Revenue rangesExamples: ["<$1M", "$1M-$10M", "$10M-$50M"]

string[]

Include if they use any of these toolsExamples: ["Salesforce", "AWS", "React"]

string[]

Must use all listed technologies

string[]

Exclude if using any of these technologies

boolean

Has a web application?

boolean

Has a mobile application?

string[]

AppStore categoriesExamples: ["News", "Finance"]

string[]

PlayStore categoriesExamples: ["Car race", "Games"]

object

iOS app rating (1–5)Format: {"min": 4, "max": 5}

object

Android app rating (1–5)Format: {"min": 4, "max": 5}

object

Number of iOS reviewsFormat: {"min": 100, "max": 10000}

object

Number of Android reviewsFormat: {"min": 100, "max": 10000}

boolean

Website listed for sale?

📈 Web Traffic & Ads

object

Total monthly visitsFormat: {"min": 1000, "max": 100000}

object

Monthly organic trafficFormat: {"min": 1000, "max": 100000}

object

Monthly paid trafficFormat: {"min": 1000, "max": 100000}

object

Estimated monthly Google Ads spend ($)Format: {"min": 1000, "max": 50000}

💰 Funding Filters

object

Last round amountFormat: {"min": 1000000, "max": 100000000}

object

Total raised fundingFormat: {"min": 1000000, "max": 100000000}

object

Months since last funding roundFormat: {"min": 1, "max": 24}

string[]

Funding stageExamples: ["Seed", "Series A", "Series B"]

string[]

Names of lead investors

object

Number of investors in the last roundFormat: {"min": 1, "max": 10}

👨‍💼 Team & Roles

object[]

Role distribution by department & rangeFormat: [{"department": "android_dev", "range": {"min": 1, "max": 100}}]

object[]

Open roles per department with rangeFormat: [{"department": "sales", "range": {"min": 1, "max": 10}}]

Response

array

Show Array of Person Objects

string

Unique identifier for the person

string

Full name of the person

string

First name

string

Last name

string

Current job title

string

Seniority level

string

LinkedIn profile URL

string

Start date of current position

string

Current city

string

Current state/region

string

Current country

string

ISO country code

string

Geographic region (NORAM, EMEA, APAC, LATAM)

string

Email address (when included)

string

Phone number (when included)

string

Organization identifier

object

Current organization details including name, domain, website, founded year, etc.

number

HTTP status code (201 for success)

string

Response message

Example Requests

curl --location 'https://api.tuesday.so/api/v1/people/search' \
--header 'X-API-KEY: your-api-key-here' \
--header 'Content-Type: application/json' \
--data '{
  "page": 1,
  "per_page": 25,
  "person_titles": ["Software Engineer"],
  "include_email": "include",
  "include_phone": "include"
}'

curl --location 'https://api.tuesday.so/api/v1/people/search' \
--header 'X-API-KEY: your-api-key-here' \
--header 'Content-Type: application/json' \
--data '{
  "page": 1,
  "per_page": 25,
  "q_organization_domains": ["salesforce.com"],
  "person_seniorities": ["Director"],
  "include_email": "include"
}'

curl --location 'https://api.tuesday.so/api/v1/people/search' \
--header 'X-API-KEY: your-api-key-here' \
--header 'Content-Type: application/json' \
--data '{
  "page": 1,
  "per_page": 25,
  "organization_industry": ["Technology"],
  "person_titles": ["Engineering"],
  "person_location": ["United States"]
}'

const searchPayload = {
  page: 1,
  per_page: 25,
  person_titles: ['Marketing Director'],
  person_seniorities: ['Director'],
  person_location: ['San Francisco'],
  organization_industry: ['Technology'],
  include_email: 'include'
};

const response = await fetch(
  'https://api.tuesday.so/api/v1/people/search',
  {
    method: 'POST',
    headers: {
      'X-API-KEY': 'your-api-key-here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(searchPayload)
  }
);

const results = await response.json();
console.log(results);

import requests

url = "https://api.tuesday.so/api/v1/people/search"
payload = {
    "page": 1,
    "per_page": 25,
    "person_titles": ["VP Sales"],
    "person_seniorities": ["VP"],
    "person_location": ["United States"],
    "organization_industry": ["Software"],
    "include_email": "include",
    "include_phone": "include"
}
headers = {
    "X-API-KEY": "your-api-key-here",
    "Content-Type": "application/json"
}

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

for person in results['data']:
    print(f"{person['name']} - {person['title']} at {person['organizations.name']}")

<?php
$payload = [
    'page' => 1,
    'per_page' => 25,
    'person_titles' => ['Software Engineer'],
    'person_seniorities' => ['Senior'],
    'person_location' => ['Austin'],
    'organization_industry' => ['Technology'],
    'include_email' => 'include'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.tuesday.so/api/v1/people/search");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: your-api-key-here',
    'Content-Type: application/json'
]);

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

$data = json_decode($response, true);
foreach ($data['data'] as $person) {
    echo $person['name'] . " - " . $person['title'] . "\n";
}
?>

Example Response

{
    "data": [
        {
            "city": "Washington",
            "country": "United States",
            "country_code": "US",
            "country_region": "NORAM",
            "email": "austin.gerner@actif.ai",
            "first_name": "Austin",
            "id": "tu_pac5zsepm",
            "job_start_date": "2022-03-01",
            "last_name": "Gerner",
            "linkedin_url": "https://www.linkedin.com/in/austin-gerner-080413b4",
            "mobile_number": "+1 570-872-7952",
            "name": "Austin Gerner",
            "organization_id": "tu_oabfyglnu",
            "organizations.founded_year": 2019,
            "organizations.linkedin_url": "https://www.linkedin.com/company/actifai",
            "organizations.name": "Actifai",
            "organizations.primary_domain": "actif.ai",
            "organizations.website_url": "https://www.actif.ai",
            "seniority": "Staff",
            "state": "District of Columbia",
            "title": "Senior Software Engineer"
        },
        {
            "city": "Greenfield",
            "country": "United States",
            "country_code": "US",
            "country_region": "NORAM",
            "email": "phil.wingham@rtx.com",
            "first_name": "Phil",
            "id": "tu_pab5rkwdc",
            "job_start_date": "2012-01-01",
            "last_name": "Wingham",
            "linkedin_url": "https://www.linkedin.com/in/phil-wingham-697200b",
            "mobile_number": "+1 765-994-1888",
            "name": "Phil Wingham",
            "organization_id": "tu_oabstv4wl",
            "organizations.linkedin_url": "https://www.linkedin.com/company/rtx",
            "organizations.name": "Rtx",
            "organizations.primary_domain": "rtx.com",
            "organizations.website_url": "https://www.rtx.com",
            "seniority": "Staff",
            "state": "Indiana",
            "title": "Senior Software Engineer Ii"
        }
    ],
    "statusCode": 201,
    "message": "Success"
}

Search Tips & Best Practices

Effective Search Strategies

Combine Multiple Filters:

Use 2-3 filters for optimal results (e.g., title + location + seniority)
Start broad, then narrow down with additional criteria

Title Matching:

Use partial titles for broader results: "Marketing" vs "Marketing Director"
Include common variations: "VP Sales", "Vice President Sales"

Location Targeting:

City names: "San Francisco", "New York"
State/region: "California", "Texas"
Country: "United States", "Germany"

Pagination Best Practices

Use limit to control page size (recommended: 10-50)
Implement pagination using offset for large result sets
Check has_more field to determine if more results exist
Total results available in pagination.total

Cost Optimization

Start searches without email/phone enrichment to preview results
Only add enrichment for final, targeted result sets
Use smaller limit values when exploring search criteria
Consider the total cost: base credits + enrichment costs per result

Pagination Example

async function getAllResults(searchParams, maxResults = 1000) {
  const allResults = [];
  let offset = 0;
  const limit = 50; // Batch size
  
  while (allResults.length < maxResults) {
    const params = new URLSearchParams({
      ...searchParams,
      limit: limit,
      offset: offset
    });
    
    const response = await fetch(
      `https://api.tuesday.so/api/v1/people/search?${params}`,
      { headers: { 'X-API-KEY': 'your-api-key-here' } }
    );
    
    const data = await response.json();
    
    if (!data.data || data.data.length === 0) break;
    
    allResults.push(...data.data);
    
    if (!data.pagination.has_more) break;
    
    offset += limit;
    
    // Rate limiting pause
    await new Promise(resolve => setTimeout(resolve, 3000));
  }
  
  return allResults.slice(0, maxResults);
}

// Usage
const results = await getAllResults({
  title: 'Software Engineer',
  location: 'California',
  seniority: 'Senior'
}, 500);

def search_all_people(search_params, max_results=1000):
    all_results = []
    offset = 0
    limit = 50
    
    while len(all_results) < max_results:
        params = {
            **search_params,
            'limit': limit,
            'offset': offset
        }
        
        response = requests.get(
            "https://api.tuesday.so/api/v1/people/search",
            params=params,
            headers={'X-API-KEY': 'your-api-key-here'}
        )
        
        data = response.json()
        
        if not data.get('data'):
            break
            
        all_results.extend(data['data'])
        
        if not data['pagination']['has_more']:
            break
            
        offset += limit
        
        # Rate limiting
        time.sleep(3)
    
    return all_results[:max_results]

# Usage
results = search_all_people({
    'title': 'Data Scientist',
    'industry': 'Technology',
    'seniority': 'Senior'
}, 300)

Credit Usage

Base per result

Email per result

Phone per result

Cost Calculation Example:

Search returning 20 results with email and phone enrichment
Base cost: 20 × 1 = 20 credits
Email enrichment: 20 × 2 = 40 credits
Phone enrichment: 20 × 3 = 60 credits
Total: 120 credits

Common Search Patterns

Sales Prospecting

# Find decision makers at target companies
?title=Director&seniority=Director&industry=Technology&company_size=501-1000

# Sales leaders in specific geography
?title=Sales&seniority=VP&location=California&include_email=include

Recruitment Searches

# Senior engineers in tech hubs
?title=Software Engineer&seniority=Senior&location=San Francisco&industry=Technology

# Marketing professionals with experience
?title=Marketing&keywords=digital marketing&seniority=Manager&country=US

Market Research

# Industry analysis by role distribution
?industry=Healthcare&company_size=1001-5000&limit=100

# Geographic concentration of talent
?title=Data Scientist&country=US&limit=50

Error Responses

400 Bad Request - Invalid Parameters

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Invalid limit value. Must be between 1 and 100"
}

400 Bad Request - Missing Search Criteria

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "At least one search criterion is required"
}

Use Cases

Sales Prospecting

Build targeted prospect lists based on title, industry, and company size

Talent Acquisition

Find qualified candidates matching specific role and experience criteria

Market Research

Analyze industry trends and talent distribution across regions

Lead Generation

Identify decision makers and influencers in target companies

People Profile API - Get detailed profile by LinkedIn URL
People Lookup API - Find specific person by name and company
Company Search API - Search for companies with filters
Company Employee Search - Find employees within specific companies

Authentication

People APIs

Company APIs

Overview

Authentication

Request Parameters

👤 Person Filters

🏢 Organization Filters

📱 Technology & Product Filters

📈 Web Traffic & Ads

💰 Funding Filters

👨‍💼 Team & Roles

Response

Example Requests

Example Response

Search Tips & Best Practices

Credit Usage

Common Search Patterns

Error Responses

Use Cases

Sales Prospecting

Talent Acquisition

Market Research

Lead Generation

​Overview

​Authentication

​Request Parameters

​📄 Pagination

​👤 Person Filters

​🏢 Organization Filters

​📱 Technology & Product Filters

​📈 Web Traffic & Ads

​💰 Funding Filters

​👨‍💼 Team & Roles

​Response

​Example Requests

​Example Response

​Search Tips & Best Practices

​Pagination Example

​Credit Usage

​Common Search Patterns

​Error Responses

​Use Cases

Sales Prospecting

Talent Acquisition

Market Research

Lead Generation

​Related Endpoints

Overview

Authentication

Request Parameters

📄 Pagination

👤 Person Filters

🏢 Organization Filters

📱 Technology & Product Filters

📈 Web Traffic & Ads

💰 Funding Filters

👨‍💼 Team & Roles

Response

Example Requests

Example Response

Search Tips & Best Practices

Pagination Example

Credit Usage

Common Search Patterns

Error Responses

Use Cases

Related Endpoints