Contents

Brand

A brand eligible for promotion through Apple Maps ads.

Declaration

object Brand

Properties

NameTypeDescription
id Requiredstring

ID of the brand. Filterable with EQUALS, IN.

namestring

Primary display name for the brand.

countryOrRegionstring

2-character ISO 3166-1 alpha-2 country or region code.

categories[string]

Modern category taxonomy identifiers. The first entry is the primary category. See BusinessCategory.

eligibilityEligibility

Ad serving eligibility for this brand. See Eligibility. Read-only. Filterable with EQUALS on eligibility.status.

creationTimedate-time

ISO-8601 timestamp when the brand record was created. Read-only.

modificationTimedate-time

ISO-8601 timestamp of the last modification. Read-only.

Discussion

The Brand object represents a business entity registered in Apple Ads. Use the id field as the promotedObjectId when creating a BUSINESS_BRAND campaign. You can actively promote only brands with eligibility.status: ELIGIBLE.

To understand the business type, use the categories field. The countryOrRegion field identifies the primary market for the brand. Use Query Brands to list brands accessible to your ad account, and Get Brand by ID to retrieve a specific brand by its identifier.

Query endpoint requests support fields marked Filterable in the properties as filter criteria. See Calling the Apple Ads Platform API for details on constructing queries.

Example

{
  "id": "123456789",
  "name": "AwayFinder",
  "countryOrRegion": "US",
  "categories": [
    "shopping.retail",
    "dining.restaurant"
  ],
  "eligibility": {
    "status": "ELIGIBLE",
    "blockedGroups": [],
    "allowedGroups": [],
    "modificationTime": "2025-01-10T08:00:00.000"
  },
  "creationTime": "2025-01-10T08:00:00.000",
  "modificationTime": "2025-01-10T08:00:00.000"
}

See Also