Get taxonomy
curl --request GET \
--url https://api.example.com/v1/taxonomyimport requests
url = "https://api.example.com/v1/taxonomy"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/taxonomy', 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.example.com/v1/taxonomy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/taxonomy"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/taxonomy")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/taxonomy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"audiences": [
{ "id": "CYBERSECURITY_PROFESSIONALS", "name": "Cybersecurity professionals", "description": "CISOs, security leaders and practitioners who evaluate or run security tools.", "fixedSeniority": false },
{ "id": "DATA_AI_PROFESSIONALS", "name": "Data, analytics and AI professionals", "description": "Data, analytics and AI leaders and practitioners: CDOs, heads of AI, data scientists, analysts.", "fixedSeniority": false },
{ "id": "IT_DECISION_MAKERS", "name": "IT decision makers", "description": "IT, security and compliance roles with final or strong influence on IT purchases.", "fixedSeniority": true },
{ "id": "SOFTWARE_DEVELOPERS", "name": "Software developers / engineers", "description": "Front-end, back-end, full-stack, DevOps, mobile and data/ML engineers.", "fixedSeniority": false },
{ "id": "BUSINESS_DECISION_MAKERS", "name": "Business decision makers (general)", "description": "Manager-and-above decision makers in any function.", "fixedSeniority": true },
{ "id": "C_SUITE_EXECUTIVES", "name": "C-suite / senior executives", "description": "CEOs and other C-level executives (CFO, COO, CTO, CMO and similar) in any function.", "fixedSeniority": true },
{ "id": "EMPLOYEE_BENEFITS_DMS", "name": "Employee benefits decision makers", "description": "Leaders who choose or administer employee benefits and retirement plans.", "fixedSeniority": true },
{ "id": "FINANCE_ACCOUNTING", "name": "Finance and accounting professionals", "description": "CFOs, controllers, treasurers, and VP/Director-level finance leaders.", "fixedSeniority": false },
{ "id": "HR_TALENT_DMS", "name": "HR and talent decision makers", "description": "HR and talent leaders who select providers or run programs.", "fixedSeniority": true },
{ "id": "KNOWLEDGE_WORKERS", "name": "Knowledge workers / employees", "description": "Full-time salaried office employees in any function.", "fixedSeniority": false },
{ "id": "LEGAL_PROFESSIONALS", "name": "Legal professionals", "description": "In-house counsel, legal operations and compliance leaders, and attorneys.", "fixedSeniority": false },
{ "id": "MARKETING_ADVERTISING_DMS", "name": "Marketing and advertising decision makers", "description": "CMOs and VP/Director-level marketing, demand gen and brand leaders.", "fixedSeniority": true },
{ "id": "OPERATIONS_FACILITIES", "name": "Operations and facilities", "description": "Manager-and-above in operations, facilities, maintenance and plant engineering.", "fixedSeniority": false },
{ "id": "PROCUREMENT_SUPPLY_CHAIN", "name": "Procurement and supply chain", "description": "Procurement, sourcing and supply chain managers and leaders.", "fixedSeniority": false },
{ "id": "SALES_REVENUE_OPERATIONS", "name": "Sales and revenue operations", "description": "Sales leaders, sellers, RevOps and sales enablement.", "fixedSeniority": false },
{ "id": "SMALL_BUSINESS_DMS", "name": "Small business decision makers", "description": "Owners and senior decision makers at companies with 1–50 employees.", "fixedSeniority": true },
{ "id": "FINANCIAL_ADVISORS", "name": "Financial advisors and wealth management", "description": "Advisors, portfolio managers and wealth management leaders at RIAs, banks and family offices.", "fixedSeniority": false },
{ "id": "EDUCATION_PROFESSIONALS", "name": "Education professionals", "description": "Teachers, administrators and staff at K–12 schools and higher education institutions.", "fixedSeniority": false }
],
"filters": {
"employeeRanges": [
{ "id": "ONE_TO_TEN", "name": "1–10 employees" },
{ "id": "ELEVEN_TO_FIFTY", "name": "11–50 employees" },
{ "id": "FIFTY_ONE_TO_FIVE_HUNDRED", "name": "51–500 employees" },
{ "id": "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND", "name": "501–1,000 employees" },
{ "id": "ONE_THOUSAND_ONE_TO_FIVE_THOUSAND", "name": "1,001–5,000 employees" },
{ "id": "FIVE_THOUSAND_ONE_PLUS", "name": "5,001+ employees" }
],
"countries": [
{ "id": "CA", "name": "Canada" },
{ "id": "DE", "name": "Germany" },
{ "id": "GB", "name": "United Kingdom" },
{ "id": "US", "name": "United States" }
],
"industries": [
{ "id": "FINANCIAL_SERVICES", "name": "Financial services" },
{ "id": "HEALTHCARE", "name": "Healthcare and life sciences" },
{ "id": "INDUSTRIAL", "name": "Industrial, energy and construction" },
{ "id": "MEDIA_ENTERTAINMENT", "name": "Media and entertainment" },
{ "id": "PROFESSIONAL_SERVICES", "name": "Professional services" },
{ "id": "PUBLIC_SECTOR_EDUCATION", "name": "Public sector, education and nonprofit" },
{ "id": "RETAIL_CONSUMER", "name": "Retail, consumer goods and hospitality" },
{ "id": "TECHNOLOGY", "name": "Technology and telecom" }
],
"seniorities": [
{ "id": "C_SUITE", "name": "C-Suite" },
{ "id": "VP", "name": "VP" },
{ "id": "OWNER", "name": "Owner" },
{ "id": "FOUNDER", "name": "Founder" },
{ "id": "PARTNER", "name": "Partner" },
{ "id": "HEAD", "name": "Head" },
{ "id": "DIRECTOR", "name": "Director" },
{ "id": "MANAGER", "name": "Manager" },
{ "id": "SENIOR", "name": "Senior" },
{ "id": "ENTRY", "name": "Entry" },
{ "id": "INTERN", "name": "Intern" }
]
}
}
Quoting
Get taxonomy
List audiences and filter values.
Get taxonomy
curl --request GET \
--url https://api.example.com/v1/taxonomyimport requests
url = "https://api.example.com/v1/taxonomy"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/taxonomy', 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.example.com/v1/taxonomy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/taxonomy"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/taxonomy")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/taxonomy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"audiences": [
{ "id": "CYBERSECURITY_PROFESSIONALS", "name": "Cybersecurity professionals", "description": "CISOs, security leaders and practitioners who evaluate or run security tools.", "fixedSeniority": false },
{ "id": "DATA_AI_PROFESSIONALS", "name": "Data, analytics and AI professionals", "description": "Data, analytics and AI leaders and practitioners: CDOs, heads of AI, data scientists, analysts.", "fixedSeniority": false },
{ "id": "IT_DECISION_MAKERS", "name": "IT decision makers", "description": "IT, security and compliance roles with final or strong influence on IT purchases.", "fixedSeniority": true },
{ "id": "SOFTWARE_DEVELOPERS", "name": "Software developers / engineers", "description": "Front-end, back-end, full-stack, DevOps, mobile and data/ML engineers.", "fixedSeniority": false },
{ "id": "BUSINESS_DECISION_MAKERS", "name": "Business decision makers (general)", "description": "Manager-and-above decision makers in any function.", "fixedSeniority": true },
{ "id": "C_SUITE_EXECUTIVES", "name": "C-suite / senior executives", "description": "CEOs and other C-level executives (CFO, COO, CTO, CMO and similar) in any function.", "fixedSeniority": true },
{ "id": "EMPLOYEE_BENEFITS_DMS", "name": "Employee benefits decision makers", "description": "Leaders who choose or administer employee benefits and retirement plans.", "fixedSeniority": true },
{ "id": "FINANCE_ACCOUNTING", "name": "Finance and accounting professionals", "description": "CFOs, controllers, treasurers, and VP/Director-level finance leaders.", "fixedSeniority": false },
{ "id": "HR_TALENT_DMS", "name": "HR and talent decision makers", "description": "HR and talent leaders who select providers or run programs.", "fixedSeniority": true },
{ "id": "KNOWLEDGE_WORKERS", "name": "Knowledge workers / employees", "description": "Full-time salaried office employees in any function.", "fixedSeniority": false },
{ "id": "LEGAL_PROFESSIONALS", "name": "Legal professionals", "description": "In-house counsel, legal operations and compliance leaders, and attorneys.", "fixedSeniority": false },
{ "id": "MARKETING_ADVERTISING_DMS", "name": "Marketing and advertising decision makers", "description": "CMOs and VP/Director-level marketing, demand gen and brand leaders.", "fixedSeniority": true },
{ "id": "OPERATIONS_FACILITIES", "name": "Operations and facilities", "description": "Manager-and-above in operations, facilities, maintenance and plant engineering.", "fixedSeniority": false },
{ "id": "PROCUREMENT_SUPPLY_CHAIN", "name": "Procurement and supply chain", "description": "Procurement, sourcing and supply chain managers and leaders.", "fixedSeniority": false },
{ "id": "SALES_REVENUE_OPERATIONS", "name": "Sales and revenue operations", "description": "Sales leaders, sellers, RevOps and sales enablement.", "fixedSeniority": false },
{ "id": "SMALL_BUSINESS_DMS", "name": "Small business decision makers", "description": "Owners and senior decision makers at companies with 1–50 employees.", "fixedSeniority": true },
{ "id": "FINANCIAL_ADVISORS", "name": "Financial advisors and wealth management", "description": "Advisors, portfolio managers and wealth management leaders at RIAs, banks and family offices.", "fixedSeniority": false },
{ "id": "EDUCATION_PROFESSIONALS", "name": "Education professionals", "description": "Teachers, administrators and staff at K–12 schools and higher education institutions.", "fixedSeniority": false }
],
"filters": {
"employeeRanges": [
{ "id": "ONE_TO_TEN", "name": "1–10 employees" },
{ "id": "ELEVEN_TO_FIFTY", "name": "11–50 employees" },
{ "id": "FIFTY_ONE_TO_FIVE_HUNDRED", "name": "51–500 employees" },
{ "id": "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND", "name": "501–1,000 employees" },
{ "id": "ONE_THOUSAND_ONE_TO_FIVE_THOUSAND", "name": "1,001–5,000 employees" },
{ "id": "FIVE_THOUSAND_ONE_PLUS", "name": "5,001+ employees" }
],
"countries": [
{ "id": "CA", "name": "Canada" },
{ "id": "DE", "name": "Germany" },
{ "id": "GB", "name": "United Kingdom" },
{ "id": "US", "name": "United States" }
],
"industries": [
{ "id": "FINANCIAL_SERVICES", "name": "Financial services" },
{ "id": "HEALTHCARE", "name": "Healthcare and life sciences" },
{ "id": "INDUSTRIAL", "name": "Industrial, energy and construction" },
{ "id": "MEDIA_ENTERTAINMENT", "name": "Media and entertainment" },
{ "id": "PROFESSIONAL_SERVICES", "name": "Professional services" },
{ "id": "PUBLIC_SECTOR_EDUCATION", "name": "Public sector, education and nonprofit" },
{ "id": "RETAIL_CONSUMER", "name": "Retail, consumer goods and hospitality" },
{ "id": "TECHNOLOGY", "name": "Technology and telecom" }
],
"seniorities": [
{ "id": "C_SUITE", "name": "C-Suite" },
{ "id": "VP", "name": "VP" },
{ "id": "OWNER", "name": "Owner" },
{ "id": "FOUNDER", "name": "Founder" },
{ "id": "PARTNER", "name": "Partner" },
{ "id": "HEAD", "name": "Head" },
{ "id": "DIRECTOR", "name": "Director" },
{ "id": "MANAGER", "name": "Manager" },
{ "id": "SENIOR", "name": "Senior" },
{ "id": "ENTRY", "name": "Entry" },
{ "id": "INTERN", "name": "Intern" }
]
}
}
Returns the audiences and filter values you can quote against. Takes no parameters.
Response
object[]
required
object
required
Audiences
id | Name | Description |
|---|---|---|
CYBERSECURITY_PROFESSIONALS | Cybersecurity professionals | CISOs, security leaders and practitioners who evaluate or run security tools. |
DATA_AI_PROFESSIONALS | Data, analytics and AI professionals | Data, analytics and AI leaders and practitioners: CDOs, heads of AI, data scientists, analysts. |
IT_DECISION_MAKERS | IT decision makers | IT, security and compliance roles with final or strong influence on IT purchases. |
SOFTWARE_DEVELOPERS | Software developers / engineers | Front-end, back-end, full-stack, DevOps, mobile and data/ML engineers. |
BUSINESS_DECISION_MAKERS | Business decision makers (general) | Manager-and-above decision makers in any function. |
C_SUITE_EXECUTIVES | C-suite / senior executives | CEOs and other C-level executives (CFO, COO, CTO, CMO and similar) in any function. |
EMPLOYEE_BENEFITS_DMS | Employee benefits decision makers | Leaders who choose or administer employee benefits and retirement plans. |
FINANCE_ACCOUNTING | Finance and accounting professionals | CFOs, controllers, treasurers, and VP/Director-level finance leaders. |
HR_TALENT_DMS | HR and talent decision makers | HR and talent leaders who select providers or run programs. |
KNOWLEDGE_WORKERS | Knowledge workers / employees | Full-time salaried office employees in any function. |
LEGAL_PROFESSIONALS | Legal professionals | In-house counsel, legal operations and compliance leaders, and attorneys. |
MARKETING_ADVERTISING_DMS | Marketing and advertising decision makers | CMOs and VP/Director-level marketing, demand gen and brand leaders. |
OPERATIONS_FACILITIES | Operations and facilities | Manager-and-above in operations, facilities, maintenance and plant engineering. |
PROCUREMENT_SUPPLY_CHAIN | Procurement and supply chain | Procurement, sourcing and supply chain managers and leaders. |
SALES_REVENUE_OPERATIONS | Sales and revenue operations | Sales leaders, sellers, RevOps and sales enablement. |
SMALL_BUSINESS_DMS | Small business decision makers | Owners and senior decision makers at companies with 1–50 employees. |
FINANCIAL_ADVISORS | Financial advisors and wealth management | Advisors, portfolio managers and wealth management leaders at RIAs, banks and family offices. |
EDUCATION_PROFESSIONALS | Education professionals | Teachers, administrators and staff at K–12 schools and higher education institutions. |
Industries
id | Covers |
|---|---|
FINANCIAL_SERVICES | Banking, insurance, investment management, capital markets, VC/PE |
HEALTHCARE | Hospitals, medical practices, pharma, biotech, medical devices |
INDUSTRIAL | Manufacturing, construction, real estate, energy, utilities, logistics, agriculture |
MEDIA_ENTERTAINMENT | Broadcast, publishing, online media, entertainment, gaming |
PROFESSIONAL_SERVICES | Legal, accounting, consulting, staffing, marketing and advertising agencies, PR |
PUBLIC_SECTOR_EDUCATION | Government, education, military, nonprofit |
RETAIL_CONSUMER | Retail, consumer goods, food and beverage, apparel, restaurants, hotels, travel |
TECHNOLOGY | Software, IT services, internet, security, hardware, semiconductors, telecom |
Seniorities
id | Name |
|---|---|
C_SUITE | C-Suite |
VP | VP |
OWNER | Owner |
FOUNDER | Founder |
PARTNER | Partner |
HEAD | Head |
DIRECTOR | Director |
MANAGER | Manager |
SENIOR | Senior |
ENTRY | Entry |
INTERN | Intern |
Errors
Only the general errors listed in the Overview.{
"audiences": [
{ "id": "CYBERSECURITY_PROFESSIONALS", "name": "Cybersecurity professionals", "description": "CISOs, security leaders and practitioners who evaluate or run security tools.", "fixedSeniority": false },
{ "id": "DATA_AI_PROFESSIONALS", "name": "Data, analytics and AI professionals", "description": "Data, analytics and AI leaders and practitioners: CDOs, heads of AI, data scientists, analysts.", "fixedSeniority": false },
{ "id": "IT_DECISION_MAKERS", "name": "IT decision makers", "description": "IT, security and compliance roles with final or strong influence on IT purchases.", "fixedSeniority": true },
{ "id": "SOFTWARE_DEVELOPERS", "name": "Software developers / engineers", "description": "Front-end, back-end, full-stack, DevOps, mobile and data/ML engineers.", "fixedSeniority": false },
{ "id": "BUSINESS_DECISION_MAKERS", "name": "Business decision makers (general)", "description": "Manager-and-above decision makers in any function.", "fixedSeniority": true },
{ "id": "C_SUITE_EXECUTIVES", "name": "C-suite / senior executives", "description": "CEOs and other C-level executives (CFO, COO, CTO, CMO and similar) in any function.", "fixedSeniority": true },
{ "id": "EMPLOYEE_BENEFITS_DMS", "name": "Employee benefits decision makers", "description": "Leaders who choose or administer employee benefits and retirement plans.", "fixedSeniority": true },
{ "id": "FINANCE_ACCOUNTING", "name": "Finance and accounting professionals", "description": "CFOs, controllers, treasurers, and VP/Director-level finance leaders.", "fixedSeniority": false },
{ "id": "HR_TALENT_DMS", "name": "HR and talent decision makers", "description": "HR and talent leaders who select providers or run programs.", "fixedSeniority": true },
{ "id": "KNOWLEDGE_WORKERS", "name": "Knowledge workers / employees", "description": "Full-time salaried office employees in any function.", "fixedSeniority": false },
{ "id": "LEGAL_PROFESSIONALS", "name": "Legal professionals", "description": "In-house counsel, legal operations and compliance leaders, and attorneys.", "fixedSeniority": false },
{ "id": "MARKETING_ADVERTISING_DMS", "name": "Marketing and advertising decision makers", "description": "CMOs and VP/Director-level marketing, demand gen and brand leaders.", "fixedSeniority": true },
{ "id": "OPERATIONS_FACILITIES", "name": "Operations and facilities", "description": "Manager-and-above in operations, facilities, maintenance and plant engineering.", "fixedSeniority": false },
{ "id": "PROCUREMENT_SUPPLY_CHAIN", "name": "Procurement and supply chain", "description": "Procurement, sourcing and supply chain managers and leaders.", "fixedSeniority": false },
{ "id": "SALES_REVENUE_OPERATIONS", "name": "Sales and revenue operations", "description": "Sales leaders, sellers, RevOps and sales enablement.", "fixedSeniority": false },
{ "id": "SMALL_BUSINESS_DMS", "name": "Small business decision makers", "description": "Owners and senior decision makers at companies with 1–50 employees.", "fixedSeniority": true },
{ "id": "FINANCIAL_ADVISORS", "name": "Financial advisors and wealth management", "description": "Advisors, portfolio managers and wealth management leaders at RIAs, banks and family offices.", "fixedSeniority": false },
{ "id": "EDUCATION_PROFESSIONALS", "name": "Education professionals", "description": "Teachers, administrators and staff at K–12 schools and higher education institutions.", "fixedSeniority": false }
],
"filters": {
"employeeRanges": [
{ "id": "ONE_TO_TEN", "name": "1–10 employees" },
{ "id": "ELEVEN_TO_FIFTY", "name": "11–50 employees" },
{ "id": "FIFTY_ONE_TO_FIVE_HUNDRED", "name": "51–500 employees" },
{ "id": "FIVE_HUNDRED_ONE_TO_ONE_THOUSAND", "name": "501–1,000 employees" },
{ "id": "ONE_THOUSAND_ONE_TO_FIVE_THOUSAND", "name": "1,001–5,000 employees" },
{ "id": "FIVE_THOUSAND_ONE_PLUS", "name": "5,001+ employees" }
],
"countries": [
{ "id": "CA", "name": "Canada" },
{ "id": "DE", "name": "Germany" },
{ "id": "GB", "name": "United Kingdom" },
{ "id": "US", "name": "United States" }
],
"industries": [
{ "id": "FINANCIAL_SERVICES", "name": "Financial services" },
{ "id": "HEALTHCARE", "name": "Healthcare and life sciences" },
{ "id": "INDUSTRIAL", "name": "Industrial, energy and construction" },
{ "id": "MEDIA_ENTERTAINMENT", "name": "Media and entertainment" },
{ "id": "PROFESSIONAL_SERVICES", "name": "Professional services" },
{ "id": "PUBLIC_SECTOR_EDUCATION", "name": "Public sector, education and nonprofit" },
{ "id": "RETAIL_CONSUMER", "name": "Retail, consumer goods and hospitality" },
{ "id": "TECHNOLOGY", "name": "Technology and telecom" }
],
"seniorities": [
{ "id": "C_SUITE", "name": "C-Suite" },
{ "id": "VP", "name": "VP" },
{ "id": "OWNER", "name": "Owner" },
{ "id": "FOUNDER", "name": "Founder" },
{ "id": "PARTNER", "name": "Partner" },
{ "id": "HEAD", "name": "Head" },
{ "id": "DIRECTOR", "name": "Director" },
{ "id": "MANAGER", "name": "Manager" },
{ "id": "SENIOR", "name": "Senior" },
{ "id": "ENTRY", "name": "Entry" },
{ "id": "INTERN", "name": "Intern" }
]
}
}