Skip to main content
GET
Get Brands by Domain
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: $0.02625 per item returned in data[]; empty results and errors are not charged. One credit per brand returned. Related: get_foreplay-getadsbybrandid, get_foreplay-brand-analytics, get_foreplay-discovery-ads.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

domain
string
required

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.

limit
integer
default:10

Pagination limit (max 10). Controls the number of brands returned per request.

Required range: x <= 10
order
string
default:most_ranked

Order of results: 'most_ranked' (default) or 'least_ranked'. Sorts brands by relevance ranking.

Response

200 - application/json

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.