Find ad audiences
curl --request POST \
--url https://api.airscale.io/v1/ad-audiences \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"work_email": "jane.doe@example.com",
"target_network": "meta"
}
'const url = 'https://api.airscale.io/v1/ad-audiences';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({work_email: 'jane.doe@example.com', target_network: 'meta'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/ad-audiences"
payload = {
"work_email": "jane.doe@example.com",
"target_network": "meta"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"status": "success",
"target_network": "meta",
"person_identifiers": {
"emails": [
{
"normalized_hash": "<string>",
"original_hash": "<string>",
"rank_order": 123
}
],
"phones": [
{
"digits_hash": "<string>",
"e164_hash": "<string>"
}
],
"maids": [
{
"maid": "<string>",
"device_type": "IDFA"
}
],
"fn_hash": "<string>",
"ln_hash": "<string>",
"ct_hash": "<string>",
"st_hash": "<string>",
"zp_hash": "<string>",
"country_hash": "<string>",
"gen_hash": "<string>",
"doby_hash": "<string>",
"dob_hash": "<string>"
},
"formatted_rows": [
{}
],
"credits_used": 5,
"credits_remaining": 123,
"linkedin_url": "<string>",
"work_email": "<string>"
}{
"error": "<string>",
"code": "invalid_input"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"status": "not_found",
"target_network": "meta",
"person_identifiers": null,
"formatted_rows": [
{}
],
"credits_used": 0,
"linkedin_url": "<string>",
"work_email": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "invalid_input"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}Find ad audiences
Find hashed emails, phones and mobile advertising IDs from a LinkedIn URL or work email, with results formatted for your chosen advertising network.
POST
/
v1
/
ad-audiences
Find ad audiences
curl --request POST \
--url https://api.airscale.io/v1/ad-audiences \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"work_email": "jane.doe@example.com",
"target_network": "meta"
}
'const url = 'https://api.airscale.io/v1/ad-audiences';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({work_email: 'jane.doe@example.com', target_network: 'meta'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/ad-audiences"
payload = {
"work_email": "jane.doe@example.com",
"target_network": "meta"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"status": "success",
"target_network": "meta",
"person_identifiers": {
"emails": [
{
"normalized_hash": "<string>",
"original_hash": "<string>",
"rank_order": 123
}
],
"phones": [
{
"digits_hash": "<string>",
"e164_hash": "<string>"
}
],
"maids": [
{
"maid": "<string>",
"device_type": "IDFA"
}
],
"fn_hash": "<string>",
"ln_hash": "<string>",
"ct_hash": "<string>",
"st_hash": "<string>",
"zp_hash": "<string>",
"country_hash": "<string>",
"gen_hash": "<string>",
"doby_hash": "<string>",
"dob_hash": "<string>"
},
"formatted_rows": [
{}
],
"credits_used": 5,
"credits_remaining": 123,
"linkedin_url": "<string>",
"work_email": "<string>"
}{
"error": "<string>",
"code": "invalid_input"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"status": "not_found",
"target_network": "meta",
"person_identifiers": null,
"formatted_rows": [
{}
],
"credits_used": 0,
"linkedin_url": "<string>",
"work_email": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "invalid_input"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}{
"error": "<string>",
"message": "<string>",
"code": "<string>"
}Use Find ad audiences to resolve a contact into audience identifiers and rows formatted for an advertising network. A successful result costs 5 Airscale credits per profile, regardless of the number of identifiers returned. No result costs 0 credits. Audience matching by the advertising network is not guaranteed.
Authenticate using
Example request body:
Provide at least one of
The public workspace limiter permits up to 60 requests per rolling second. Upstream capacity can produce additional 429 responses. There is no client-supplied idempotency key: a new HTTP request is a new lookup. After a timeout, check your balance before retrying. A new request can be charged independently.
Authorization: Bearer <AIRSCALE_API_KEY> and send JSON with Content-Type: application/json.
curl --request POST 'https://api.airscale.io/v1/ad-audiences' \
--header "Authorization: Bearer $AIRSCALE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"work_email":"jane@example.com","target_network":"meta"}'
{
"linkedin_url": "https://www.linkedin.com/in/jane-doe",
"work_email": "jane@example.com",
"target_network": "meta"
}
linkedin_url or work_email. The supported target_network values are meta, google, x, reddit, tiktok, linkedin, snapchat, pinterest, amazon, and universal. Omission or null selects universal. Other fields are rejected.
Successful response
HTTP 200 returns:| Field | Meaning |
|---|---|
status | success |
linkedin_url, work_email | Normalized inputs, when supplied |
target_network | Selected network |
person_identifiers | Available identifiers; fields may be omitted or null |
formatted_rows | Array of dictionaries containing network-specific column names and string values |
credits_used | 5 |
credits_remaining | Balance after settlement |
person_identifiers can contain:
emails: pairs oforiginal_hashandnormalized_hash, withrank_orderwhen supplied.phones:digits_hashande164_hashpairs.maids:maidwithdevice_typeequal toIDFAorAAID, when known. Preserve device identifiers as returned; do not hash them again.- Additional SHA-256 demographic fields:
fn_hash,ln_hash,ct_hash,st_hash,zp_hash,country_hash,gen_hash,doby_hash,dob_hash.
formatted_rows for the selected network; universal is network-independent data that you must map before upload. This endpoint does not create or upload an audience to an advertising account.
No result and errors
HTTP 404 for a valid lookup returnsstatus: "not_found", the normalized inputs and selected network, person_identifiers: null, formatted_rows: [], and credits_used: 0.
| HTTP status | Meaning |
|---|---|
| 400 / 422 | Invalid JSON, unsupported fields, invalid profile URL/email or unsupported network |
| 401 | Missing or invalid API key |
| 403 | Insufficient credits |
| 413 | Body exceeds 16 KiB |
| 429 | Request rate limit reached |
| 502 / 503 | Lookup or settlement unavailable; no successful result is returned |
| 504 | Lookup timed out and upstream outcome is unknown; no automatic provider replay is performed |
Find hashed emails or ad audiences
Use Find hashed emails when you only need email hashes. Use this endpoint when you also need phone hashes, mobile advertising identifiers, or network-specific rows. Each operation costs 5 credits per found profile; you do not need to call both to get email hashes.In the Airscale app
The same lookup is available as Find ad audiences in your tables. Select the target network, inspect the available identifiers in the cell details, and export a profile or the column as audience CSV when formatted rows are available. Review Authentication and rate limits before sending lookups in bulk.Authorizations
Body
application/json
Provide linkedin_url, work_email, or both. Other fields are rejected.
Response
Usable identifiers or formatted rows found. Costs 5 credits.