Get Brands By Domain
curl --request GET \
--url https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain', 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.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"ad_library_id": "15087023444",
"brand_id": "bYeKOahyGopmGKMHiWit",
"name": "Nike"
}
],
"error": null,
"metadata": {
"count": 1,
"cursor": null,
"status_code": 200,
"success": true
}
}Foreplay
Get Brands By Domain
Discover brands advertising from a given domain; returns brand_id and ad_library_id for downstream calls.
GET
https://api.aisa.one
/
apis
/
v1
/
foreplay
/
brand
/
getBrandsByDomain
Get Brands By Domain
curl --request GET \
--url https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain', 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.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"ad_library_id": "15087023444",
"brand_id": "bYeKOahyGopmGKMHiWit",
"name": "Nike"
}
],
"error": null,
"metadata": {
"count": 1,
"cursor": null,
"status_code": 200,
"success": true
}
}Discover brands that advertise from a given
domain. This is a discovery lookup — you do not need to already track the brands. Each brand record in data[] includes the Foreplay brand_id and the ad_library_id (page_id). Feed brand_id into get_foreplay-getadsbybrandid and ad_library_id into get_foreplay-brand-analytics. limit max is 10.
Example: GET /foreplay/brand/getBrandsByDomain?domain=nike.com returns Nike with brand_id: "bYeKOahyGopmGKMHiWit" and ad_library_id: "15087023444".
Billing: per item returned in data[]; empty results and errors are not charged. Current prices are on aisa.one/api. One credit per brand returned.
Related: get_foreplay-getadsbybrandid, get_foreplay-brand-analytics, get_foreplay-discovery-ads.
Request contract
- Method and path: GET /apis/v1/foreplay/brand/getBrandsByDomain
- Availability: enabled
- Request URL template: https://api.aisa.one/apis/v1/foreplay/brand/getBrandsByDomain
- domain: query; required
- limit: query; optional
- order: query; optional
- Runtime facts: 799c2645862e25f3076e45d5e7d545772f57444689dd138cd88f92c37554b81c
{
"operationId": "get_brands_by_domain",
"method": "GET",
"path": "/apis/v1/foreplay/brand/getBrandsByDomain",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "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 based on the provided domain. The returned brands are potential matches and are not guaranteed to be definitively associated with the domain.",
"in": "query",
"name": "domain",
"required": true,
"schema": {
"type": "string"
}
},
{
"description": "Pagination limit (max 10). Controls the number of brands returned per request.",
"in": "query",
"name": "limit",
"required": false,
"schema": {
"default": 10,
"maximum": 10,
"type": "integer"
}
},
{
"description": "Order of results: 'most_ranked' (default) or 'least_ranked'. Sorts brands by relevance ranking.",
"in": "query",
"name": "order",
"required": false,
"schema": {
"default": "most_ranked",
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.875,
"estimate_source": "profile_seed",
"evidence_source": "response_body",
"maximum_units": 50,
"unit": "provider_credit",
"unit_rate_usd": 0.0
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Usage-based billing; Default request estimate: $0.875 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.875
- Declared unit rate (USD): 0.0
- Billing unit: provider_credit
- Cost contract: response_count
- Published reference multiplier: 1.0
- Declared maximum count/units: 50
- Settlement evidence source: response_body
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
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 based on the provided domain. The returned brands are potential matches and are not guaranteed to be definitively associated with the domain.
Pagination limit (max 10). Controls the number of brands returned per request.
Required range:
x <= 10Order of results: 'most_ranked' (default) or 'least_ranked'. Sorts brands by relevance ranking.
Response
JSON envelope with metadata and a data[] array of brand objects (each includes brand_id and ad_library_id). Each brand in data[] counts as one billed item.
The response is of type object.