Read-only public interface · v1 beta

DoseWiki Public API

Use the live DoseWiki substance database in websites, research tools, and harm-reduction resources. The API returns stable, public-safe JSON projections and never exposes editor-only metadata.

OpenAPI specification View sample response

Quick start

Requests are anonymous and require no API key. Send a standard HTTP GET request from a server or browser. Cross-origin requests are supported with wildcard CORS.

const response = await fetch(
  "https://dose.wiki/api/v1/substances/mdma"
);

if (!response.ok) throw new Error(`DoseWiki API: ${response.status}`);

const { data, meta } = await response.json();
console.log(data.title, data.slug, meta.api_version);

Endpoints

GET/api/v1/meta

API version, documentation, licensing, and disclaimer metadata.

GET/api/v1/substances

A cursor-paginated collection of public substance summaries. Supports limit and cursor parameters.

GET/api/v1/substances/{slug}

The complete article, citations, normalized reagent results, and molecule resources.

GET/api/v1/substances/{slug}/reagent-tests

Normalized authored or point-in-time ProtestKit reagent results with provenance.

GET/api/v1/substances/{slug}/replications

The canonical substance article replication collection with cursor paging, public association context, and media rights.

GET/api/v1/replications

Cursor-paginated public image and video replications. Filter by effect or media type.

GET/api/v1/replications/{slug}

One replication with public attribution, rights, and media metadata.

GET/api/v1/effects/{slug}/replications

All image and video replications associated with one subjective effect.

GET/api/v1/molecules/{slug}.svg?scheme=dosewiki

A sandboxed molecule SVG in the dose.wiki, Effect Index light, or Effect Index dark color scheme.

GET/api/v1/openapi.json

The machine-readable OpenAPI 3.1 specification.

Data model and provenance

Articles and citations

Substance detail includes every public canonical article section, structured references, source citations, supporting citations, and both canonical pharmacology binding sites and the backwards-compatible receptor profile. Citation evidence and editorial review metadata remain private.

Reagent results

Authored article results take precedence. Otherwise the API returns the imported ProtestKit snapshot and labels its source. A source of none is an explicit no-result state, not permission to query ProtestKit live.

Molecule schemes

Request scheme=dosewiki, scheme=effect-index, or scheme=effect-index-dark. Canonical editor depictions are preferred, with the packaged static SVG collections as a resilient fallback.

Replication rights

Replication media has item-specific rights and is not automatically covered by the article dataset license. Check each item's rights, license, credit, source, and rightsholder fields before reuse.

Usage limits

Default page size: 25 substances
Maximum page size: 100 substances
Rate limit: 120 requests per minute per IP
Responses are cached at the CDN for five minutes

Reuse and safety

DoseWiki content is provided for harm-reduction education and is not medical advice. Check the licensing page before republishing content or media outside the core article dataset.

Read licensing and reuse terms

This unlisted page is intentionally absent from site navigation. The API is beta: versioned v1 response fields remain stable, additive fields may appear, and write operations are not exposed.