TGS
API
tgs-011
TGS11 — Product country support, regions, and ordinal GridRank
TGS11 introduces structured country and region data for products, a new ordinal ranking field on gridRank, and a firstClaimedAt timestamp on roots.
Products can now declare which countries they are available in, and every country links to a UN M49 sub-region (e.g. South America, Eastern Asia) for regional grouping and filtering.
- Added
regionsNew table of UN M49 sub-regions: id, name, slug, m49Code, parentRegionId. - Added
supportsCountriesNew join table declaring which countries a product is available in (productId → countryId). - Added
countries.regionIdLinks each country to its UN M49 sub-region. - Added
gridRank.ranking1-based ordinal position — lower is better. Recommended for Top-N lists and threshold filters. Sort with order_by: { ranking: Asc }. A missing gridRank record means unranked, not rank 0; rankings update every 24 hours. - Added
roots.firstClaimedAtDate this profile was first claimed by a user on The Grid. Complements the existing firstPublicValidation / lastPublicValidation fields.
Known limitation: country.region.parentRegion cannot be traversed in a single query yet — query parentRegionId and match it yourself.