- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
BrandSeasonalityIndex
The seasonality index shows whether a brand has a recurring seasonal revenue pattern.
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
The seasonality index shows whether a brand has a recurring seasonal revenue pattern. It measures how much the revenue concentrates in some months, and the month in which the revenue peaks each year.
The index answers two questions for each eligible brand:
- Is the business seasonal?
giniScoremeasures how much the revenue concentrates in some months. - If the business is seasonal, when is the peak?
recurringPeakMonthgives the calendar month with the highest concentration of revenue.
For example, a ski resort has a high giniScore, with a recurringPeakMonth of December. A tax preparation office peaks in early spring, with a recurringPeakMonth of April. The index shows the pattern, not its cause. Possible causes are the weather (an ice cream shop) and a regulatory deadline (a tax preparer). Other causes are the academic calendar (a school supply store), a holiday (a Christmas tree farm), and other factors.
Revenue concentration: giniScore
Section titled “Revenue concentration: giniScore”The Gini score measures how much the card revenue concentrates in some months. It goes from 0, when the revenue is the same each month, to 1, when all the revenue is in one month. A score of 0.4 or more shows a meaningful seasonal concentration. Use 0.4 as the threshold for a seasonal business.
| Score | Meaning | Examples |
|---|---|---|
| Less than 0.4 | The revenue is almost the same all year. The business is not seasonal. | A restaurant, a gas station |
| 0.4 to 0.6 | Moderate seasonality. There is a clear peak, but the revenue spreads across several months. | An ice cream shop, a garden center |
| 0.6 to 0.8 | Strong seasonality. Most of the revenue is in a short period. | A tax preparer, a farm |
| More than 0.8 | Extreme concentration. Almost all the revenue is in 1 or 2 months. | A Halloween costume store, a Christmas tree farm |
Peak month: recurringPeakMonth and peakMonthRevenueShare
Section titled “Peak month: recurringPeakMonth and peakMonthRevenueShare”recurringPeakMonth is the month in which the revenue concentrates most. The peak month must be the same in all observed periods, not in one year only.
Data sources
Section titled “Data sources”The index comes from the card transaction revenue of a rolling 36-month observation window. A brand is eligible only when its history and transaction volume are sufficient for a reliable result. A brand is eligible if:
- It has at least $10,000 in card revenue in each 12-month period of the observation window.
- It has approximately 4 years or more of revenue history.
The index uses the revenue history of each business, not its industry or location. Not all tax preparers are seasonal, and not all ice cream shops are seasonal. An ice cream shop in Miami can have the same revenue all year, while one in Minnesota peaks sharply in summer.
Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → seasonalityIndexes → BrandSeasonalityIndex.
Brand.seasonalityIndexes
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
id |
ID | UUID! |
The unique identifier of this object. |
firstObservedDate |
First Observed Date | String |
The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only. |
lastObservedDate |
Last Observed Date | String |
The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate. |
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
giniScore |
Gini Score | Float |
A score from 0 to 1 measuring how concentrated a business’s card revenue is across months. |
recurringPeakMonth |
Recurring Peak Month | String |
The month (e.g. “July”) where card revenue is most concentrated across observed periods. |
peakMonthRevenueShare |
Peak Month Revenue Share | Float |
The revenue share of the peak calendar month, expressed as a value between 0 and 1. |
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. |
|
internalBrandId |
String |
The internalId of the brand that this attribute describes. |
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.
Example
Section titled “Example”query { search(searchInput: { entityType: BRAND name: "Safeway" conditions: { limit: 1 } }) { ... on Brand { id seasonalityIndexes(first: 1) { edges { node { id firstObservedDate lastObservedDate rank giniScore } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "seasonalityIndexes": { "edges": [ { "node": { "id": "00000038-0000-37d3-0000-0a8000000000", "firstObservedDate": null, "lastObservedDate": null, "rank": 0, "giniScore": 0.03 } } ] } } ] }}