https://api.sandbase.ai/v1/api/foreplay/brands-by-domainFind the advertiser brands Foreplay tracks for a website domain, with brand ID, name, logo and ad counts, to use in brand ad lookups.
Your output will appear here
Complete the inputs, then click Run.
Find the advertiser brands Foreplay tracks for a website domain, with brand ID, name, logo and ad counts, to use in brand ad lookups.
curl -X POST "https://api.sandbase.ai/v1/api/foreplay/brands-by-domain" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "nike.com", "limit": 1}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain name to search for. This can be a full URL (e.g., 'https://example.com') or just the domain (e.g., 'example.com'). The system will automatically format and clean the domain. This endpoint looks up candidate brands |
limit | integer | No | Pagination limit (max 10). Controls the number of brands returned per request. |
order | string | No | Order of results: 'most_ranked' (default) or 'least_ranked'. Sorts brands by relevance ranking. |
Billed at the actual upstream cost of each call (about $0.0175 for the request above). Failed calls are not charged.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/foreplay/brands-by-domain" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"limit": 1,
"order": "most_ranked",
"domain": "nike.com"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
domainstringrequiredDomain name to search for. This can be a full URL (e.g., 'https://example.com') or just the domain (e.g., 'example.com'). The system will automatically format and clean the domain. This endpoint looks up candidate brands based on the provided domain. The returned brands are potential matches and are not guaranteed to be definitively associated with the domain.
limitintegerNumber of results (1-20). Each returned item is billed at about $0.0175, so this caps the cost of one call.
Default: 10
orderstringOrder of results: 'most_ranked' (default) or 'least_ranked'. Sorts brands by relevance ranking.
Default: "most_ranked"
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
| API | Price | Response |
|---|---|---|
Foreplay Brands by DomainThis API Foreplay | From $0.0175 per call | JSON |
Foreplay | From $0.0525 per call | JSON |
Foreplay | From $0.0525 per call | JSON |
Foreplay | From $0.1225 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/foreplay/brands-by-domain with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
From $0.0175 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: domain (string). Optional: limit (integer) and order (string). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous).
No. Foreplay Brands by Domain runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Foreplay API access separately.