🐜AssistAnt · Pro directory
Website Kit › Spec

business.json: a business’s own facts, in one small public file

Specification v0.1 · November 19, 2026 · License: CC BY 4.0 (example code: MIT)

A local business publishes its own facts as JSON at https://<its site>/.well-known/business.json, and the same facts as a ## Business facts block in /llms.txt. Anyone may read, write, validate or build tools for it. It needs no account, no registry and no AssistAnt. It complements schema.org JSON-LD (which stays the standard for search engines); its job is one clean, dated copy of the facts that any program can fetch without parsing a web page.

Status: proposed, v0.1. No AI assistant or search engine has said it reads this file. We publish it so the people building websites and AI tools can, and we will keep it small and backward compatible.

Rules

  1. Location: /.well-known/business.json on the business’s own website (RFC 8615 well-known path), served as application/json, UTF-8, public (no login, no cookie wall). One business per file; a multi-location business publishes one file per location site or lists the main location.
  2. Only the owner’s own facts. No reviews, ratings or claims about other businesses. Say only what is true today; leave a field out rather than guess.
  3. updated is required and changes whenever the owner re-confirms the facts. Readers should treat a file not updated in over a year as possibly stale.
  4. Mirror: the same facts, as short - Label: value lines under ## Business facts, in /llms.txt. If the two disagree, the JSON file wins.
  5. Consistency: the name, phone and address should match the page’s schema.org JSON-LD and the business’s public profiles.
  6. Extending: unknown fields are allowed; readers ignore what they don’t understand. Prefix private extensions (x_yourtool_…).

Fields

name required
The business name customers know.
updated required
YYYY-MM-DD: the day the owner last confirmed these facts.
phone / website / email / booking one required
At least one way to reach the business. Phone in E.164 (+16155550134) preferred.
description
One or two plain sentences in the owner’s words.
category
A schema.org type: LocalBusiness, Plumber, HVACBusiness, Electrician, AutoRepair …
services
List of plain service names.
address
{street, city, region, postal_code, country}. Service-area businesses may leave out the street.
service_area
List of towns, counties or ZIPs served.
hours
List of schema.org openingHours strings ("Mo-Fr 08:00-17:00").
hours_note
Free text, e.g. "Phone answered 24/7".
booking
{phone, url, how}.
profiles
Public profile URLs (same meaning as schema.org sameAs).
verified_by
Independent checks of these facts: [{name, url, note}]. Any directory or association may be named; none is required.
spec, spec_version
This page and "0.1".

Machine-readable: JSON Schema.

Example

The llms.txt mirror

Tools