curl --request POST \
--url https://api.getanyapi.com/v1/run/person_enrichment.bettercontact \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"companyDomain": "stripe.com",
"firstName": "Patrick",
"lastName": "Collison",
"linkedinUrl": "https://www.linkedin.com/in/patrickcollison"
}
'import requests
url = "https://api.getanyapi.com/v1/run/person_enrichment.bettercontact"
payload = {
"companyDomain": "stripe.com",
"firstName": "Patrick",
"lastName": "Collison",
"linkedinUrl": "https://www.linkedin.com/in/patrickcollison"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
companyDomain: 'stripe.com',
firstName: 'Patrick',
lastName: 'Collison',
linkedinUrl: 'https://www.linkedin.com/in/patrickcollison'
})
};
fetch('https://api.getanyapi.com/v1/run/person_enrichment.bettercontact', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getanyapi.com/v1/run/person_enrichment.bettercontact",
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([
'companyDomain' => 'stripe.com',
'firstName' => 'Patrick',
'lastName' => 'Collison',
'linkedinUrl' => 'https://www.linkedin.com/in/patrickcollison'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getanyapi.com/v1/run/person_enrichment.bettercontact"
payload := strings.NewReader("{\n \"companyDomain\": \"stripe.com\",\n \"firstName\": \"Patrick\",\n \"lastName\": \"Collison\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/patrickcollison\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getanyapi.com/v1/run/person_enrichment.bettercontact")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"companyDomain\": \"stripe.com\",\n \"firstName\": \"Patrick\",\n \"lastName\": \"Collison\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/patrickcollison\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getanyapi.com/v1/run/person_enrichment.bettercontact")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companyDomain\": \"stripe.com\",\n \"firstName\": \"Patrick\",\n \"lastName\": \"Collison\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/patrickcollison\"\n}"
response = http.request(request)
puts response.read_body{
"costUsd": 123,
"items": 123,
"output": {
"data": {
"enriched": true,
"city": "<string>",
"company": {
"about": "<string>",
"addressCity": "<string>",
"addressCountry": "<string>",
"addressState": "<string>",
"addressStreet": "<string>",
"addressZipcode": "<string>",
"companyId": "<string>",
"countryCode": "<string>",
"crunchbaseUrl": "<string>",
"description": "<string>",
"directionsUrl": "<string>",
"domain": "<string>",
"employees": 123,
"employeesOnLinkedin": 123,
"followers": 123,
"founded": 123,
"headquarters": "<string>",
"headquartersAddress": "<string>",
"headquartersCity": "<string>",
"headquartersCountry": "<string>",
"image": "<string>",
"industryCode": "<string>",
"legalId": "<string>",
"legalName": "<string>",
"linkedinId": "<string>",
"linkedinUrl": "<string>",
"name": "<string>",
"organizationType": "<string>",
"phone": "<string>",
"size": "<string>",
"website": "<string>"
},
"connections": 123,
"contactId": "<string>",
"country": "<string>",
"countryCode": "<string>",
"currentCompany": "<string>",
"doNotContact": true,
"email": "<string>",
"emailProvider": "<string>",
"emailStatus": "<string>",
"firstName": "<string>",
"followers": 123,
"fullName": "<string>",
"gender": "<string>",
"image": "<string>",
"jobTitle": "<string>",
"lastName": "<string>",
"linkedinId": "<string>",
"linkedinUrl": "<string>",
"location": "<string>",
"postalCode": "<string>",
"provider": "<string>"
},
"found": true
},
"provider": "<string>",
"replayed": true,
"hint": "<string>",
"jqError": "<string>",
"resultId": "<string>"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Person Enrichment - BetterContact
Run one contact through BetterContact’s email waterfall from a name plus company domain or a LinkedIn URL, and get the winning address with its deliverability verdict, the provider that found it, and the employer record. Only a matched contact is billable.
Price: $82.80 per 1,000 requests (flat per request - same cost regardless of results returned).
Routing: one lane serves this API today, so a failed attempt has nowhere to fail over to. Payment outcome follows the selected rail’s settlement policy.
Catalog: Person Enrichment - BetterContact pricing and uptime - live USD price, lane routing, and measured 30-day uptime. Every Person_enrichment endpoint.
curl --request POST \
--url https://api.getanyapi.com/v1/run/person_enrichment.bettercontact \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"companyDomain": "stripe.com",
"firstName": "Patrick",
"lastName": "Collison",
"linkedinUrl": "https://www.linkedin.com/in/patrickcollison"
}
'import requests
url = "https://api.getanyapi.com/v1/run/person_enrichment.bettercontact"
payload = {
"companyDomain": "stripe.com",
"firstName": "Patrick",
"lastName": "Collison",
"linkedinUrl": "https://www.linkedin.com/in/patrickcollison"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
companyDomain: 'stripe.com',
firstName: 'Patrick',
lastName: 'Collison',
linkedinUrl: 'https://www.linkedin.com/in/patrickcollison'
})
};
fetch('https://api.getanyapi.com/v1/run/person_enrichment.bettercontact', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getanyapi.com/v1/run/person_enrichment.bettercontact",
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([
'companyDomain' => 'stripe.com',
'firstName' => 'Patrick',
'lastName' => 'Collison',
'linkedinUrl' => 'https://www.linkedin.com/in/patrickcollison'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getanyapi.com/v1/run/person_enrichment.bettercontact"
payload := strings.NewReader("{\n \"companyDomain\": \"stripe.com\",\n \"firstName\": \"Patrick\",\n \"lastName\": \"Collison\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/patrickcollison\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getanyapi.com/v1/run/person_enrichment.bettercontact")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"companyDomain\": \"stripe.com\",\n \"firstName\": \"Patrick\",\n \"lastName\": \"Collison\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/patrickcollison\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getanyapi.com/v1/run/person_enrichment.bettercontact")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companyDomain\": \"stripe.com\",\n \"firstName\": \"Patrick\",\n \"lastName\": \"Collison\",\n \"linkedinUrl\": \"https://www.linkedin.com/in/patrickcollison\"\n}"
response = http.request(request)
puts response.read_body{
"costUsd": 123,
"items": 123,
"output": {
"data": {
"enriched": true,
"city": "<string>",
"company": {
"about": "<string>",
"addressCity": "<string>",
"addressCountry": "<string>",
"addressState": "<string>",
"addressStreet": "<string>",
"addressZipcode": "<string>",
"companyId": "<string>",
"countryCode": "<string>",
"crunchbaseUrl": "<string>",
"description": "<string>",
"directionsUrl": "<string>",
"domain": "<string>",
"employees": 123,
"employeesOnLinkedin": 123,
"followers": 123,
"founded": 123,
"headquarters": "<string>",
"headquartersAddress": "<string>",
"headquartersCity": "<string>",
"headquartersCountry": "<string>",
"image": "<string>",
"industryCode": "<string>",
"legalId": "<string>",
"legalName": "<string>",
"linkedinId": "<string>",
"linkedinUrl": "<string>",
"name": "<string>",
"organizationType": "<string>",
"phone": "<string>",
"size": "<string>",
"website": "<string>"
},
"connections": 123,
"contactId": "<string>",
"country": "<string>",
"countryCode": "<string>",
"currentCompany": "<string>",
"doNotContact": true,
"email": "<string>",
"emailProvider": "<string>",
"emailStatus": "<string>",
"firstName": "<string>",
"followers": 123,
"fullName": "<string>",
"gender": "<string>",
"image": "<string>",
"jobTitle": "<string>",
"lastName": "<string>",
"linkedinId": "<string>",
"linkedinUrl": "<string>",
"location": "<string>",
"postalCode": "<string>",
"provider": "<string>"
},
"found": true
},
"provider": "<string>",
"replayed": true,
"hint": "<string>",
"jqError": "<string>",
"resultId": "<string>"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>",
"code": "<string>",
"payment": {
"costUsd": 1,
"rail": "<string>",
"settlementState": "charged_undelivered"
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Authorizations
Your AnyAPI key as a Bearer token.
Headers
Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict.
1 - 255Query Parameters
Optional. Comma-separated keys (dotted paths like author.name descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the data/items envelope is unwrapped, not against the top-level response envelope, so use jq to reshape the whole envelope. Shrinks the response without changing cost.
Optional. Cap the number of result rows returned; a _truncated note reports how many were withheld so you can page via the API's own limit. Does not change cost.
x >= 0Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.
Optional. A jq expression applied to the result envelope; its output replaces output (multiple outputs collect into an array). Reshape freely, e.g. jq=.data | {title, description, md: .markdown[:3500]}. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a jqError. Does not change cost.
Body
- Person Enrichment - BetterContact input
- Person Enrichment - BetterContact input
- Person Enrichment - BetterContact input
Employer domain, e.g. stripe.com. The strongest company signal for the waterfall.
1Contact's first name.
1Contact's last name.
1Employer name, for when you have no domain.
1Arbitrary identifiers echoed back on the result, for joining the answer to your own records.
Contact's LinkedIn profile URL, which raises the match rate.
Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted.
x >= 1Response
Normalized result.
USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free.
Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count.
Normalized output, or null when the replay payload was not retained.
Hide child attributes
Hide child attributes
The matched contact, or null when the waterfall found none.
Hide child attributes
Hide child attributes
True when the waterfall matched a contact. A false answer is a legitimate miss and is not billed.
City.
The contact's employer.
Hide child attributes
Hide child attributes
Company about text.
Address city.
Address country.
Address state or region.
Street address.
Address postal code.
BetterContact's own company identifier.
ISO 3166-1 alpha-2 country code.
Company Crunchbase profile URL.
Company description.
Map directions URL for the office.
Company domain.
Employees BetterContact counts.
Employees LinkedIn shows for the company.
LinkedIn follower count.
Year the company was founded.
Headquarters as one display string.
Headquarters street address.
Headquarters city.
Headquarters country.
Company logo URL.
Industry classification code.
Company registration number.
Registered legal name.
Company LinkedIn numeric id.
Company LinkedIn page URL.
Company name.
Organization type.
Company switchboard number.
Employee headcount band.
Company website URL.
LinkedIn connection count.
BetterContact's own contact identifier.
Country.
ISO 3166-1 alpha-2 country code.
Current employer as BetterContact names it.
True when the contact is on a do-not-contact list.
The email address the waterfall settled on.
Mailbox provider behind the address, e.g. Google.
Deliverability verdict for the address, e.g. valid, catch_all_safe, catch_all_not_safe, undeliverable, not_found.
First name.
LinkedIn follower count.
Contact's full name.
Gender recorded for the contact.
Contact's profile picture URL.
Current job title.
Last name.
Contact's LinkedIn numeric id.
Contact's LinkedIn profile URL.
Location as one display string.
Postal code.
Which data source in the waterfall produced the address.
False when the waterfall matched no contact.
Always "AnyAPI".
True when this response replays the durable result of an earlier run without billing or upstream execution.
Optional one-line nudge, absent when there is nothing to say. large_result: suggests the fields/max_items/summary/jq controls for a big response. paging_unavailable: means this result came from a source that cannot return a nextCursor, so it may be INCOMPLETE and cannot be continued - re-run with requireCursor: true to be served only by a source that can page, which may cost more per request.
Present only when a jq expression failed; output then carries the full unshaped result and this explains why the reshape did not apply.
Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache.