# Foreplay Brands by Domain API

> Find the advertiser brands Foreplay tracks for a website domain, with brand ID, name, logo and ad counts, to use in brand ad lookups.

Source: https://www.sandbase.ai/apis/foreplay/brands-by-domain
API reference: https://www.sandbase.ai/apis/foreplay/brands-by-domain#api

## Facts

- Provider: Foreplay
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/foreplay/brands-by-domain`
- Price: From $0.0175 per call
- Capabilities: api, foreplay, advertising, ad library
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/foreplay/brands-by-domain` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `domain` | string | yes |  |
| `limit` | integer | no |  |
| `order` | string | no |  |

## FAQ

### How do I use the Foreplay Brands by Domain API?

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.

### How much does the Foreplay Brands by Domain API cost?

From $0.0175 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Foreplay Brands by Domain API accept?

Required: domain (string). Optional: limit (integer) and order (string). The Parameters table and the Playground on this page list every field.

### What does the Foreplay Brands by Domain API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Foreplay developer account or API key?

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.

## README

### Foreplay Brands by Domain

Find the advertiser brands Foreplay tracks for a website domain, with brand ID, name, logo and ad counts, to use in brand ad lookups.

#### Request

```bash
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`.

#### Parameters

| 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. |

#### Pricing

Billed at the actual upstream cost of each call (about $0.0175 for the request above). Failed calls are not charged.