CREHQ Location Intelligence

Get a brand's site-selection criteria and target real-estate profile: preferred site types, building/lot size, target geographies and trade areas, and expansion markets. Essential for landlords, brokers, and site-selectors who want to know what a tenant is looking for before pitching them space.

PREMIUM INTELLIGENCE — CREHQ Modeled Site Pattern for a brand: empirical medians, ranges, percentiles, road-type mix, co-tenant mix, trade-area density, recent-location context, and layer coverage/confidence. Use this to infer revealed-preference site patterns from where the brand actually operates. Do not present it as company-stated requirements unless the response includes stated-requirement provenance. The backing REST route is staged until Mark approves production publication.

Get one brand's PUBLISHED site-selection criteria as CREHQ has recorded them: unit size, site types, lease terms, traffic, population, household income, and co-tenancy text, with source class and vintage where available; direct source links depend on account access. These are what the brand states it wants. `typical_site`, when returned, is a separate CREHQ-DERIVED observed pattern across current US locations: its median and p25-p75 middle half are a benchmark, never a brand requirement, acceptance threshold or prediction. Never blend the two evidence classes. Published criteria are often part…

Compare one to five brands against one site in a single call. It deliberately separates (1) brand-published criteria and source dates, (2) CREHQ-derived observed medians and p25-p75 ranges across current US locations, and (3) measured spatial co-tenancy. The observed comparison is a benchmark only—not a requirement, recommendation, acceptance threshold, probability or evidence a brand wants the site. By default it uses the most recent Site Context report the signed-in account opened on crehq.com; pass an address or lat/lng to override it. Relay campus/group-quarters cautions, missing evidence …

List all dataset categories with counts — a quick map of how CREHQ's data products are organized across verticals.

Download a licensed dataset by slug in your chosen format (CSV, JSON, GeoJSON, or XLSX). Requires a tier/contract that includes the dataset. Returns the raw payload (or a signed link) for direct ingestion.

Get full metadata for one dataset by slug: row count, column schema, coverage, verification methodology, last-refresh date, and licensing notes — everything needed to evaluate it before download.

Browse CREHQ's catalog of packaged, ready-to-license datasets (whole-brand footprints, vertical rollups, FDD financials, etc.), filterable by category, country, and freshness. Each entry exposes row counts, schema, and refresh date — the menu of bulk data products.

For CREHQ Pro self-serve keys, spend the key's one monthly controlled intelligence preview credit. Returns a bounded evidence frame for a tenant-credit, site-selection, co-tenancy, franchise, or monitoring question without exposing raw premium tables or redistribution rights. Free keys receive a 402 upgrade prompt; full enterprise keys should use the dedicated premium tools directly.

Get one location's full record by id: geocoded address, brand, lifecycle status, attributes (e.g. drive-thru, square footage, fuel/EV ports where applicable), and the sources that verify it exists.

Full append-only event log for ONE physical store/site (by entity_uid): every open/close/rebrand/attribute change CREHQ has recorded, with dates and sources. Time-series provenance for a single location.

PREMIUM INTELLIGENCE — CREHQ Modeled Site Profile for one physical location: traffic/AADT, route class, trade-area demographics, radius demographics, drive-time context, nearby tenants, format signals, lifecycle timing, and provenance/coverage flags. This is CREHQ-modeled from observed location/context data, not a brand-stated requirement sheet. The backing REST route is staged until Mark approves production publication.

Bulk location retrieval for ETL/pipeline use: fetch many locations in one call by a list of ids, a list of brands, or a GeoJSON polygon (e.g. a custom market boundary). Use this instead of looping single-location calls when hydrating a dataset.

Pull the cross-brand location LIFECYCLE STREAM — openings, closings, relocations, ownership/brand changes — since a timestamp. The real-time expansion/contraction signal that drives prospecting, market-monitoring, and 'who's moving right now' alerts. Returns a next-since cursor for incremental polling.

List individual store/branch/site records, filterable by brand, US state, city, county and category. Each location carries a stable entity_uid, geocoded address, open/closed status, and a multi-source verification trace. The raw, government-cross-checked footprint behind any brand. This free/sandbox footprint output does NOT include credit signals, ownership/rating history, capital structure, or tenant-credit diligence; for those requests use crehq_company_credit_signals if available, otherwise call crehq_request_upgrade with requested_data='credit_signals'. Category vocabulary: every row carr…

Bounded radius search: sample tracked locations within N miles of a lat/lng point. Powers trade-area analysis, competitor mapping, and 'what's near this address' questions. It only knows stores already operating; for businesses that have NOT opened yet — pending licences, new permits, build-outs — call crehq_openings_nearby. Returns distance-sorted storefronts verified against government records and brand-published data, across every vertical CREHQ covers. Rows are tracked chains and registries, not a census of every business, so a missing business is not proof it is absent. Pagination: total_…

Search locations across multiple fields at once — name, brand, street address, city/state/geography. Use when you have a fuzzy description of a physical place rather than an id.

What is OPENING near a point, from dated public records: pending and newly issued liquor licences, new food-service permits, and commercial / multi-family building permits within a straight-line radius, with counts by type, the top named records (establishment name, plain-language status, date, distance, matched CREHQ brand when one resolves), and a per-brand roll-up. This sees a store BEFORE it opens and before any locator lists it — use it for 'is anyone already moving into this space?', 'what is under construction near this site?' and to check a leasing brochure's vacancy list against reali…

Query rows from a dataset snapshot the connected key owner has purchased. This is for buyer-owned point-in-time snapshots, not live CREHQ refresh. The response includes snapshot_as_of, hosted_access_until, artifact basis, and row results. If hosted access expired, it returns an upgrade/update-plan message while acknowledging that the buyer still owns the original file snapshot.

List dataset snapshots purchased by the owner of the connected CREHQ self-serve key. Use this before querying a buyer-owned dataset through MCP. It shows snapshot_as_of, hosted_access_until, whether hosted MCP querying is active, and whether the buyer still owns the file snapshot after hosted access expires.

PREMIUM INTELLIGENCE — context for a brand's most recently observed locations: event timing, address/market, traffic counts when backfilled, route class, trade-area demographics, radius demographics, drive-time context, and coverage flags. Useful for questions like 'traffic counts for the last 50 Starbucks locations CREHQ observed.' Event rows distinguish verified openings from first-observed/reconciliation events. The backing REST route is staged until Mark approves production publication.

Continue from the most recent Site Context report opened on crehq.com while the account that owns this key was signed in. Use this before asking the user to repeat an address after they move from the website into the connector. It returns the saved address/point and a compact Site Context report by default. The saved site is account context only: it does not prove the user owns, represents, chose or approved the property.

First call crehq_access_summary and check the dedicated brand/site/FDD tools. Competition accounts must use their included alternatives and should not be sent to checkout. For other accounts, use this when the API confirms the requested data is not included: CREHQ Credit Signals / credit-intelligence profiles, ownership/sponsor/capital-structure/rating-history data, site-selection criteria, real-estate requirements, tenant requirements, franchise/FDD data, Item 19 financials, real-estate contacts, source provenance, event/change history, bulk dataset downloads, whitespace analysis, co-tenancy,…

Resolve a public venue or business identity across hotels, restaurants, retail, healthcare, banks, auto dealers, EV charging, and other location categories. Use this when the user asks which chain or brand a venue belongs to, who operates or owns a location, or whether a venue is independent. Provide at least one of url, venue_name, or address; additional identity hints improve disambiguation. Returns affiliation_status (branded, independent, not_a_commercial_venue, or unresolved), canonical name, entity type, brand, operator, parent company, confidence, evidence, and checked time. Treat indep…

What CREHQ knows around ANY US point or street address, in one report: ring demographics (1, 2, 3 and 5 miles: population, households, income, education, housing, with the tract's median gross rent trend and five-year projections), the nearest measured traffic counts (AADT by road, with year and distance), jobs located within each ring, anchors (hospitals only, never urgent care or clinics; colleges and universities; transit where covered), operating chain locations nearby by category, and the openings pipeline (dated licence and permit signals, coverage per record type). Use it first for 'tel…

CREHQ's tenant-shortlist engine for a vacant unit. Describe the space (size, site type, state, category) and, optionally, what you measured at the site (AADT traffic, population and household income within a radius) and its co-tenants; it returns a ranked list of brands that could fit. It keeps two kinds of evidence apart: STATED fit, from what a brand PUBLISHES about the space it wants, and REVEALED fit, from percentiles over where the brand actually operates today across its current US estate. Coverage is uneven: many brands publish no requirements, and revealed percentiles exist only where …

FLAGSHIP DIFFERENTIATOR (PREMIUM) — given a physical site (site_uid), return the full chronological tenancy history: every brand that has EVER occupied that address and when. Answers 'this was a Blockbuster, then a Sprint store, now a Chipotle.' Unmatched for backfill/teardown analysis, second-generation space, and landlord due diligence. (Intel & Enterprise tiers.)

Add a CREHQ brand to a team's own shortlist (or one of its lists) — the team's own list, not CREHQ data, never another team's; idempotent, the same brand twice returns the existing item. Pass the brand's slug or company_id (an exact brand name also works) and never invent one: when unsure, resolve it with crehq_companies_search first, and if the API answers brand_not_found with did_you_mean, ask the user rather than picking a suggestion silently.

Remove one item from a team's own shortlist or list by its item id (from crehq_team_items). This changes only the team's own list, not CREHQ data, and never another team's.

The brands and sites on a team's shortlist or one of its lists (its own picks, not CREHQ data; nothing from other teams). Each brand item carries the CREHQ id, slug and name to pass to the other tools.

Call this FIRST before any other crehq_team_* tool: the team workspaces this CREHQ account belongs to, with id, slug, role, window and counts. A team workspace holds the team's own shortlists, compare boards, saved sites and notes written by its members (not CREHQ data), and nothing here reaches another team's workspace.

Write a note in a team's workspace on a brand, a saved site, a list or the team itself; @Name mentions a team member. Notes are the team's own working notes (visible to its members and staff, never to another team), not CREHQ data. For a brand target pass the slug or company_id — never a guessed name — and put what the note rests on (tool names, URLs, figures) in evidence.

Read a team's notes, optionally only those on one brand, site, list or the team. They are the team members' own working notes (may be wrong or out of date), not CREHQ data, and never another team's.

The site-selector runs a team saved for one of its own sites (site id from crehq_team_list / crehq_team_items), newest first, each with the parameters used and a snapshot of the result at that time. These are the team's own saved snapshots (never another team's), not CREHQ data and not a live answer: re-run crehq_site_selector_match for current results.

Save (or, with id, update) a site the team is evaluating — name, address, coordinates, suites and the traffic/population/income the team measured — in the team's own workspace so members and the site selector can reuse it. It stores the team's own inputs, not CREHQ data, and never another team's site.

Time-series trends for ONE brand: outlet-count history, fee/royalty trends, and FDD financial trajectory over time. The growth/health curve of a concept in a single call.

Geographic trend analysis: metro/state concentration and opening/closing velocity across CREHQ's footprint. Surfaces which markets are heating up or cooling down across brands and verticals.

PREMIUM INTELLIGENCE — whitespace analysis: postal codes/markets where a brand's competitors are present and performing but the brand itself is ABSENT. The ranked, data-driven shortlist of where a chain should expand next. Built on CREHQ's full multi-vertical footprint, verified against government records. (Intel & Enterprise tiers.)