PUBLIC DATA

SmellBook's public data, free to download.

No licence has yet been granted for SmellBook-created datasets. They are publicly readable; reuse beyond citation and quotation needs permission until a licence is published. Licence notice.

The files below hold a deliberately limited selection of the website's public facts, in forms that programs and spreadsheets can read. The descriptions use some technical terms because they are written for developers and researchers. These files can only be read, not changed. No user-account, write or recommendation API is currently provided, and no service-level agreement is implied. They hold nothing private: no hidden graph data, no search-ranking weights and no recommendation logic.

SCHEMA VERSION1.0

LATEST DATASET RELEASE2026-11-11

CATALOG FIELDS14

DATA ENDPOINTS146

/data/manifest.json

Manifest

Schema version, endpoint list, exported fields and explicit private-field exclusions.

/data/catalog.json

Catalog

The 200 published smell entries with IDs, names, other names, summaries, descriptors, status and revision metadata.

/data/taxonomy.json

Taxonomy

Public categories, descriptors and public types with their canonical smell memberships.

/data/evidence.json

Evidence

The public source registry and VERIFIED claim records.

/data/changelog.json

Changelog

Structured public product and atlas change records.

/data/provenance.json

Provenance

Explicit profile-to-claim-to-source evidence relationships with stable public identifiers.

/data/relations.json

Relations

Explicit unweighted editorial related-smell links.

/data/identifiers.json

Identifiers

Canonical public smell, claim and source identifiers with canonical URLs.

/data/resolve.json?id=SB-0001

Identifier resolver

Read-only exact-ID resolution example.

/data/quality.json

Quality report

Structural integrity and maintenance diagnostics for the public atlas.

/data/quality.ndjson

Quality issues

One hard structural issue per line; empty for a passing release.

/data/snapshot.json

Current snapshot

Current documented public snapshot metadata.

/data/snapshots.json

Snapshot registry

Formal public snapshot history from 2026-09-22 forward.

/data/latest.json

Latest snapshot pointer

Stable pointer to the newest registered public snapshot.

/data/catalog.csv

Catalog table

The public canonical catalog in spreadsheet-friendly CSV.

/data/catalog.tsv

Catalog table

The public canonical catalog in tab-separated form.

/data/claims.csv

Claims table

Verified public claim records in spreadsheet-friendly CSV.

/data/claims.tsv

Claims table

Verified public claim records in tab-separated form.

/data/sources.tsv

Sources table

Public source records in tab-separated form.

/data/sources.csl.json

Citation library

Public source records in CSL JSON for citation managers.

CSL JSON ↗

/data/sources.bib

BibTeX library

Public source records in BibTeX form.

/data/sources.ris

RIS library

Public source records in RIS form.

/data/sources.md

Markdown bibliography

Human-readable public source bibliography.

/data/catalog.ndjson

Catalog stream

One canonical profile JSON object per line.

/data/claims.ndjson

Claims stream

One VERIFIED claim JSON object per line.

/data/sources.ndjson

Sources stream

One registered source JSON object per line.

/data/changelog.ndjson

Changelog stream

One public changelog record per line.

/data/provenance.ndjson

Provenance stream

Profile, claim and source relationship records as line-delimited JSON.

/data/relations.ndjson

Relations stream

One unweighted editorial relation record per line.

/data/smells/rain.json

Smell entity record

Example stable per-smell JSON record.

/data/claims/petrichor-rain-on-dry-ground.json

Claim entity record

Example stable per-claim JSON record.

/data/sources/petrichor-1964.json

Source entity record

Example stable per-source JSON record.

/data/context.jsonld

JSON-LD context

Schema.org mappings plus public SmellBook vocabulary terms.

JSON-LD ↗

/data/graph.jsonld

Linked-data graph

Public smell, claim and source entities as JSON-LD.

JSON-LD ↗

/data/bundle.json

Dataset bundle

Portable manifest for snapshot, resources, schemas, checksums and citation guidance.

/data/dictionary.json

Data dictionary

Field types, nullability and public semantic definitions.

/data/facets.json

Taxonomy facets

Category, descriptor and public-type membership records.

/data/facet-memberships.ndjson

Facet memberships

One facet-to-smell membership per line.

/data/categories/nature.json

Category record

Example category facet record.

/data/descriptors/fresh.json

Descriptor record

Example descriptor facet record.

/data/types/source.json

Type record

Example public-type facet record.

/data/lineage.json

Data lineage

Version-controlled inputs and their derived public outputs.

/data/reproducibility.json

Reproducibility contract

Build commands, snapshot/checksum pointers and runtime non-dependencies.

/data/consumer-contract.json

Consumer contract

Read methods, CORS, caching, schema headers and compatibility semantics.

/data/errors.json

Error catalog

Stable public error codes and HTTP status meanings.

/data/examples.json

Consumer examples

Representative read-only requests and expected results.

/data/resource-registry.json

Resource registry

Methods, media types, schemas, cache classes and stability metadata for public resources.

/data/search-corpus.json

Search corpus

Searchable public fields and records without internal scoring weights.

/data/search-corpus.ndjson

Search corpus stream

One searchable public record per line.

/data/search-fields.json

Search field contract

Search field meanings and normalization semantics.

/data/cache-policy.json

Cache policy

Public response cache classes and freshness semantics.

/data/capabilities.json

Capabilities

Current public support state and routes.

/data/support-matrix.json

Support matrix

Capability status meanings and current boundaries.

/data/source-lifecycle.json

Source lifecycle

Current lifecycle states for registered sources and VERIFIED claims.

/data/corrections.json

Corrections

Correction notices SmellBook has published, each keyed to the permanent identifier of the record it corrects.

/data/rights.json

Rights registry

Current public/project/third-party reuse and ownership boundaries.

/data/attribution.json

Attribution registry

Registered source attribution and publisher-rights guidance.

/data/evidence-coverage.json

Evidence coverage

Profile/source/claim VERIFIED-linkage coverage without confidence scoring.

/data/vocabulary.json

Vocabulary registry

Controlled public labels and definitions.

/data/privacy-posture.json

Privacy posture

Current runtime-aligned public privacy declarations.

/data/accessibility-status.json

Accessibility status

Source-level commitments and structural requirements.

/data/locale-readiness.json

Locale readiness

Current English-first language/localization posture.

/data/docs-map.json

Documentation map

Grouped public developer/policy documentation routes.

/data/openapi.json

OpenAPI

OpenAPI 3.1 description of representative stable public read routes.

/data/snapshot-deltas.json

Snapshot deltas

Registered snapshot metadata/resource/count deltas.

/data/fingerprints.json

Record fingerprints

SHA-256 fingerprints over selected public record fields.

/data/provenance-chains.json

Provenance chains

Explicit smell-to-VERIFIED-claim-to-source paths.

/data/provenance-chains.ndjson

Provenance chain stream

One explicit evidence chain per line.

/data/deprecations.json

Deprecations

Current public deprecation registry and policy.

/data/http-semantics.json

HTTP semantics

Methods, CORS, shared headers, media types and status meanings.

/data/retention-policy.json

Retention policy

Public atlas traceability, snapshot and removal boundaries.

/data/ordering.json

Ordering contract

Deterministic collection order and serialization semantics.

/data/canonical-registry.json

Canonical registry

Entity canonical URLs, route families and redirect policy.

/data/query-contract.json

Query contract

Documented query parameters, limits and error behavior.

/data/minimization.json

Data minimization

Explicit public/private exclusions and exposure rules.

/data/security-posture.json

Security posture

Configured response protections and explicit non-claims.

/data/stability.json

Stability registry

Current route stability classes and field-change semantics.

/data/schema-examples.json

Schema examples

Representative current public payloads selected from live data structures.

/data/evidence-recency.json

Evidence recency

Descriptive source publication-age metadata.

/data/editorial-provenance.json

Editorial provenance

Public field-origin and third-party source metadata origins.

/data/download-contract.json

Download contract

Suggested filenames, media types and download boundaries.

Smell map topology

Deterministic visual coordinates plus explicit unweighted public relation edges.

/data/personal-contract.json

Personal SmellBook local contract

Browser-local storage schema, limits, portability and privacy boundaries—not user data.

/data/applied-scent.json

Applied scent contract

Public scent intents, sensory directions, space contexts, presence levels and safety/appropriateness boundaries.

/data/labs.json

Labs experimental export

Transparent EXPERIMENTAL representations and PREDICTED relation candidates with declared methods and boundaries.

/data/labs-evaluation.json

Labs evaluation export

Deterministic run manifests, candidate explanations and descriptive coverage audits without confidence or performance scoring.

/data/labs-review.json

Labs review export

Read-only review packets, non-numeric rubric prompts and deterministic challenge sets with zero promotion effect.

/data/labs-review-context.json

Labs review context export

Claim-specific VERIFIED context, registered-source context, evidence-gap markers and provenance trails with zero relation-verification effect.

/data/labs-review-lenses.json

Labs review lenses export

Deterministic review-packet groupings and a descriptive category coverage matrix without ranking, confidence or quality scoring.

/data/labs-change-audit.json

Labs change audit export

Deterministic SHA-256 fingerprints over declared public Labs fields with NOT_COMPARABLE historical semantics when prior fingerprints were not retained.

/data/labs-audit-snapshots.json

Labs audit snapshots export

Immutable retained audit-input sets beginning on 2026-09-29, with literal public input projections and SHA-256 digests.

/data/labs-audit-comparison.json

Labs audit comparison export

Truthful comparison between retained snapshots, with descriptive ADDED, REMOVED, CHANGED and UNCHANGED states.

/data/graph-export.json

Knowledge graph export

Every entity with its permanent identifier and every typed relationship with provenance and evidence class, released through the rights gate with licence status and a sha256 digest.

/data/graph-export.ndjson

Knowledge graph export stream

The same knowledge graph as header, node and edge records, one per line.

/data/permanent-ids.json

Permanent identifiers

The append-only registry of smellbook:{type}:{key} identifiers with sealed issuance blocks and retirements.

/data/entities.json

Entity model

Entity types with definitions and every entity record.

/data/relation-types.json

Relation types

Typed relationship vocabulary with semantics, direction, status and edge counts.

/data/evidence-model.json

Evidence model

The six evidence classes, provenance mapping and the design-only contribution review model.

/data/data-rights.json

Data rights

Rights classes, field-level rights, source attributions and the dataset licence status.

/data/locales.json

Locales

English base language, the Spanish pilot names, review states, fallback and hreflang rules.

/data/source-intake.json

Source intake

Source intake workflow, queue, registered source rights and evidence gaps.

/data/entry-standard.json

Entry standard

Publication criteria, development signals and the result for every entry.

/data/atlas-baseline.json

Atlas quality baseline

The twelve entry checks, every entry's facts and findings with their resolutions, and the descriptor review. No score or ranking.

/data/entry-pipeline.json

Entry pipeline

Editorial draft, review and publication workflow for new entries.

/data/entry-identity.json

Entry identity

Name uniqueness, reviewed near-duplicates and the merge policy.

/data/evidence-agenda.json

Evidence research agenda

Open research questions for entries without a VERIFIED claim.

/data/historical-sources.json

Historical sources

Historical and archival sources: holdings, catalogue records, digitised copies, dates with their precision, and rights. Catalogue metadata identifies a source; it never verifies a claim.

/data/worksheets/historical-sources.csv

Historical source worksheet

One row per proposed historical passage: catalogue record, digitised copy, location, the time it describes and rights. Registered passages are filled examples.

/data/institutions.json

For institutions

How museums, archives, universities and teachers can use SmellBook: uses, identifier guidance, research bundles and offline tools.

/data/heritage-templates.json

Heritage record templates

Templates for object, archival-document, place and practice records, with worked examples from registered evidence and invented illustrative records.

/data/institution-test-kit.json

Institution self-test kit

Example records and a LIDO export, some deliberately broken, with the result each must give.

/data/entries.ris

Entry citations (RIS)

Every entry as an RIS reference with its record number, permanent identifier and revision.

/data/bundles/evidence.json

Evidence bundle

VERIFIED claims, how they were checked, historical sources and molecules, with the SHA-256 of every part.

/data/heritage.json

Olfactory heritage

Localities and traditions in the olfactory heritage atlas, with their identity references and check status.

/data/molecules.json

Molecules

Odorant molecules named in VERIFIED claims, the role each claim gives them, and their verified PubChem, InChIKey, Wikidata and ChEBI identifiers.

/data/claim-support.json

Claim support

How each VERIFIED claim was checked against its source's own words; 2 could not be, because no abstract was available.

/data/citation-verification.json

Citation verification

How every source citation was checked against the publisher's or catalogue's metadata, with the check runs.

/data/graph/smell/rain.json

Graph records

One knowledge-graph entity with its typed relationships: /data/graph/{type}/{key}.json.

/dataset-releases

Dataset releases

Every release of the knowledge-graph dataset: what changed, its digest, and how to cite it.

/data/vocabulary.skos.jsonld

SKOS vocabulary

Smell descriptors (English and Spanish labels) and places by kind as SKOS concept schemes for thesaurus and collection systems.

JSON-LD ↗

/data/heritage-record-schema.json

Heritage record schema (draft)

Draft JSON Schema for olfactory heritage records that link to SmellBook identifiers. No institution uses it yet.

/data/writing-guide.json

Writing guide

Machine-checked rules for entry text, applied to entries and drafts.

/data/type-facets.json

Type facets

Controlled kind and qualifiers for every entry type label.

/data/governance.json

Editorial governance (draft)

Roles, review separation, reserved decisions and conflicts of interest.

/data/worksheets/source-checking.csv

Source-checking worksheet

One row per open research question, with columns for a researcher to record a checked citation.

/data/worksheets/spanish-review.csv

Spanish review worksheet

Every Spanish pilot name with its English source, for a native speaker to confirm, correct or reject.

/data/worksheets/language-pack.csv

Language pack worksheet

Every smell, descriptor, place and material with its English name and context, for proposing names in a new language. Checked offline; nothing is submitted.

/data/licence.txt

Dataset licence notice

Current licence status of SmellBook-created datasets, generated from one switch.

/data/dataset-releases.json

Dataset release history

Date, digest, node and edge counts, chain hash, notes and archive address of each knowledge-graph dataset release.

/data/graph-entities.csv

Graph entities table

Every knowledge-graph entity as a spreadsheet row, with localized names and review status.

/data/graph-relations.csv

Graph relations table

Every typed relationship as a spreadsheet row, with provenance.

/data/names.json

Names index

Every SmellBook name in every language mapped to permanent identifiers, with shared names flagged, for reconciling other datasets.

/data/learn.json

SmellBook Learn data

Every Learn course, lesson, word pair and classroom guide, linked to the graph by permanent identifier.

/data/datapackage.json

Data package

The knowledge-graph dataset as a Frictionless Data Package with digests and table schemas.

/data/dcat.jsonld

DCAT-AP catalogue

SmellBook's public datasets described in the European DCAT application profile used by open-data portals.

JSON-LD ↗

/data/graph-health.json

Graph health

Orphans, dangling edges, domain and range checks and degree by entity type.

/data/graph/relations/described-as.ndjson

Relation exports

Every edge of one relation type as NDJSON: /data/graph/relations/{type}.ndjson.

/data/schema.json

Schema registry

JSON Schema definitions and compatibility rules for public records.

/data/inventory.json

Data inventory

Formats, media types, schema mappings and record counts.

/data/citation.json

Citation metadata

Suggested citation, version and attribution boundaries.

/data/contract.json

Developer contract

Read-only guarantees, versioning rules and public-surface exclusions.

/data/routes.json

Route index

Documentation and machine-readable public routes.

/data/README.txt

Data README

Plain-text starting point for the public data surface.

/data/version.json

Version

Milestone, canonical website and data schema version.

/data/release.json

Release manifest

Milestone, canonical website, counts, critical routes and machine surfaces.

/data/checksums.json

Checksums

SHA-256 digests for core deterministic public export structures.

EXPORTED CATALOG FIELDS

idslugnamealiasessummarytypecategorydescriptorsstatuscreatedAtupdatedAtrevisioncanonicalUrlverifiedClaimIds

DELIBERATELY EXCLUDED

graphWeightssimilarityScoresrankingWeightsrecommendationFormulapersonalizationStateuserProfileprivateRelationships

USE & LICENSING

Publicly readable does not mean unrestricted ownership transfer.

These endpoints make selected public facts and SmellBook-authored catalog fields easier to read by software. They do not grant a blanket license to SmellBook branding, original editorial writing, taxonomy presentation, internal systems, or third-party source material. Individual source rights and licenses remain their own.

STABILITY

Schema version 1.0 is an early public contract. Fields may evolve in later versions, but SmellBook should change the schema version when a breaking change alters the meaning or availability of exported fields.