Skip to content
Console(opens in a new tab)

Brand

A brand is a business as its customers see it, such as a trade name.

Subject. This entity is a subject: a kind of record that a search can start from. Name it in two places: entityType: BRAND in the search input, and ... on Brand in the fields you read.

A brand is a business as its customers see it, such as a trade name. A brand can operate at many operating locations and can belong to one or more legal entities. A brand can also be affiliated with other brands.

Field Type Description
id ID! The unique ID of the brand.
internalId String A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number.
enigmaId String An optional identifier that Enigma assigns to this object when custom identification is applicable.
tieBreakerMetadata BrandTieBreakerMetadata Values that order search results with equal match scores. The API does not fill these values today.
searchMetadata Searchmetadata Match details that show how this result matched each search input. The API does not fill these details today.

Each one is a connection: read it through edges { node { … } }, page it with first, and narrow it with conditions.

Field Leads to Description
names BrandName The customer-facing version of the name that best represents the business. Default first: 3.
websites Website A website associated with a business. Default first: 100.
operatingLocations OperatingLocation The operating locations where this brand operates. Default first: 100.
legalEntities LegalEntity The legal entities that do business as this brand. Default first: 100.
affiliatedBrands Brand Other brands affiliated with this brand, such as a dealer or a store inside another store. Each edge carries the affiliationType. Default first: 100.
cardTransactions BrandCardTransaction Contains quantitative information about the card transactions processed by the brand. Default first: 3.
industries Industry The industry within which the business operates. Default first: 100.
records Record A structured entry from an upstream data source, such as a government filing or business registration, from which Enigma derives and links business entities. Default first: 10.
legalEntitiesOwns LegalEntity The legal entities that own this brand. Default first: 100.
websitesIsProfileOf Website A website associated with a business. Default first: 100.
roles Role These are roles which people (and other legal entities) hold at U.S. businesses. Default first: 100.
legalEntitiesLicenses LegalEntity The legal entities that license this brand. Default first: 100.
reviewSummaries BrandReviewSummary A summary of customer reviews across the operating locations associated with a brand. Default first: 3.
revenueQualities BrandRevenueQuality Warnings and issues related to the revenue of this brand. Default first: 3.
seasonalityIndexes BrandSeasonalityIndex The seasonality index shows whether a brand has a recurring seasonal revenue pattern. Default first: 3.
locationDescriptions BrandLocationDescription A summary of where a brand operates geographically, showing either the top states for brands with multiple locations or the specific city and state for brands with a single location. Default first: 3.
isMarketables BrandIsMarketable Contains a boolean value indicating whether the brand is marketable. Default first: 3.
activities BrandActivity Identifies businesses that engage in activities with a high compliance risk. Default first: 3.

Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.

query {
search(searchInput: {
entityType: BRAND
name: "Safeway"
conditions: { limit: 1 }
}) {
... on Brand {
id
internalId
enigmaId
names(first: 1) { edges { node { name } } }
}
}
}

Response, as returned:

{
"data": {
"search": [
{
"id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a",
"internalId": null,
"enigmaId": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a",
"names": {
"edges": [
{
"node": {
"name": "SAFEWAY"
}
}
]
}
}
]
}
}