Docs

Reference for building against the Mogean catalog: what every column means, how it ships, what you can do with it, and how the schema evolves over time.

Data dictionary

Every column in the compat schema — canonical name, type, a real example value, and the national fill rate as of the current monthly update. Fill rate below 95% is flagged; it means the field is legitimately sparse for some source rows, not broken.

Column	Type	Example	Fill rate (national)
poi_id	string	47d24d0914e3985acc123e52fe95cae9f87a2ddbb3bbd1c7a503c425dd9b	100.0%
name	string	Western Union	100.0%
latitude	float	42.337495	100.0%
longitude	float	-71.105236	100.0%
categories	string	Business and Professional Services > Automotive Service > Au	93.2%
street	string	MAIN STREET	81.9%
city	string	NEW YORK	100.0%
state	string	CA	100.0%
zip	string	10001	100.0%
country	string	US	100.0%
county	string	Los Angeles	100.0%
timezone	string	America/New_York	100.0%
date_refreshed	string	2012-05-21	99.8%
tel	string	(800) 275-8777	70.0%
website	string	https://bluerhino.com	52.4%
geohash	string	drt2vgq9zc	100.0%
brand_name	string	Western Union	12.3%
sensitive_flag	int	0	100.0%
is_sub_location	int	0	100.0%
parent_poi_id	string	9bd0d01dbbc02b3db3e2d47eaf40e383701f147892049da879854afe5257	1.1%

Enumerated from the current monthly update's manifest at build time.

Formats & delivery

Every dataset ships CSV and Parquet; geo datasets add GeoJSON. Delivery is a signed download link, not an upload queue or a support ticket.

CSV

UTF-8, header row, RFC 4180 quoting. The lowest-friction format — opens anywhere.

Parquet

Columnar, typed, compressed. The format most of this niche doesn't offer — built for warehouse loads at the full 23M-row scale.

GeoJSON

Available on geo datasets (brand, category, state, and custom datasets) for direct map use.

Every purchase — whether it’s a published dataset or one you build yourself in the explorer — resolves to a signed URL, valid 24 hours, re-issuable from your account page (up to three re-issues per day per order). A dataset you build in the explorer is created on purchase, usually in under two minutes, then handed to you through the same signed-link flow.

Downloading a purchased dataset

# Signed URL, valid 24h — re-issue from your account page after that.
curl -L -o brand.csv \
  "https://dl.mogean.com/orders/8f2c.../brand.csv?X-Amz-Expires=86400&Signature=..."

Licensing

Three plain-English tiers, published multipliers, chosen at checkout — not buried in a terms page.

Internal use

Analysis, BI, and internal tooling at your organization. The default at checkout.

Product-embedded

Redistributed inside a product or service you sell to your own customers.

10x

Redistribution

Resold or redistributed as data. Full-dataset redistribution is contact-only.

NOTICE.txt

Every artifact ships packaged with an attribution notice matching its tier. Full-tier products carry upstream open-data license texts (this catalog blends Foursquare Open Source Places and Overture Maps data alongside brand-extracted and government-registry rows); the Ground Truth US tier is government-sourced only and carries government attribution alone.

NOTICE.txt — full tier

# Foursquare Open Source Places — Apache License 2.0
# Overture Maps Foundation — CDLA-Permissive-2.0
# Full license texts included in this archive.

NOTICE.txt — Ground Truth US tier

# This dataset contains only pipeline-extracted and government-registry
# sourced rows. No third-party open-data attribution applies.

Schema changelog

Column-level changes to the compat schema, newest first.

No schema changes yet this manifest version

Column additions and breaking changes will be listed here, newest first, once the catalog has shipped more than one schema version.

current schema: manifest 2026_07_r11 · release 2026-07-02

API

Today, the catalog is a bulk-file product: browse, buy, download. A programmatic API is on the roadmap.

API — coming soonProgrammatic access to the same catalog the storefront sells. No date yet — the waitlist decides the order we build it in.

Manifest excerpt

The storefront is a pure function of one file. Every product page, price, and sample on this site is generated from catalog_manifest.json— this is a trimmed excerpt of the current monthly update's.

catalog_manifest.json — excerpt

{
  "drop_date": "2026-07-02",
  "totals": {
    "pois_sellable": 22733437,
    "active_brands": 3413
  },
  "schema": {
    "columns": [
      { "name": "poi_id", "type": "string", "fill_rate_national": 1 }
      // 20 compat columns at this drop
    ]
  }
}