- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Subject
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.
Fields
Section titled “Fields”| 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. |
Connections
Section titled “Connections”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. |
Math fields
Section titled “Math fields”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.
Where it appears
Section titled “Where it appears”LegalEntity.brandsLegalEntity.ownsBrandsLegalEntity.licensesBrandsBrand.affiliatedBrandsWebsite.brandsWebsite.isProfileOfBrandsOperatingLocation.brandsRole.brandsRecord.brandsIndustry.brands
Example
Section titled “Example”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" } } ] } } ] }}