Look up Meta ads
curl --request POST \
--url https://api.airscale.io/v1/meta-ads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "example.com"
}
'const url = 'https://api.airscale.io/v1/meta-ads';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({domain: 'example.com'})
};
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/meta-ads"
payload = { "domain": "example.com" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"page_id": "meta-123",
"number_of_ads": 4,
"credits_consumed": 1
}
Meta Ads
Look up Meta ads for a company domain. Rate limit: 60 requests per minute per workspace.
POST
/
v1
/
meta-ads
Look up Meta ads
curl --request POST \
--url https://api.airscale.io/v1/meta-ads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "example.com"
}
'const url = 'https://api.airscale.io/v1/meta-ads';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({domain: 'example.com'})
};
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/meta-ads"
payload = { "domain": "example.com" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"page_id": "meta-123",
"number_of_ads": 4,
"credits_consumed": 1
}
Look up Meta ads for one company. Send exactly one
domain field: a bare hostname or HTTP(S) URL. Paths and queries are ignored after normalization. IP literals, credentials, non-default ports, and invalid domain labels are rejected. The JSON body must fit within 16 KiB.
Usage and credits
The limit is 60 requests per minute per workspace. You need at least 1 credit before the lookup can start. A finite numericnumber_of_ads greater than zero costs 1 credit. A zero, missing, nonnumeric, or nonpositive count costs 0 credits.
The response preserves provider fields and adds credits_consumed. Fields such as page_id and number_of_ads are optional; do not assume every provider response includes them or uses a fixed type. An upstream HTTP 204 response becomes a zero-ad result.
Timeouts and retries
The provider lookup can take up to 90 seconds. HTTP504 means that lookup timed out without a debit. Use bounded backoff for temporary errors and rate limits.
This endpoint does not support caller idempotency keys. Retrying a successful lookup can run and bill another lookup, including when the original response was lost.
Next step
Review credit balance or rate limits before scheduling more lookups.Authorizations
Use an Airschool workspace API key. Never expose the key in client-side code.
Body
application/json
Bare company hostname or HTTP(S) URL. Whitespace is trimmed; hostname is lowercased and leading www. and trailing dot are removed. Paths and queries are ignored. IP literals, credentials, non-default ports, and invalid domain labels are rejected. Maximum JSON body size: 16 KiB (oversize returns 400).
Minimum string length:
1Response
Provider result with the settled credit cost. Provider fields are optional and are not coerced to fixed types.