Research API

Quick Start

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/countries/germany"

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/papers?format=csv&compound=psilocybin" \
  -o papers.csv

Endpoints

Query Parameters

Common list query parameters (some are endpoint-specific):

OpenAPI and incremental sync

The complete, machine-readable OpenAPI 3.1 contract for all v1 GET routes is available in the API specification. Pro integrations can start an incremental sync with a strict ISO-8601 since value, then send only the opaque meta.cursor returned by each page. Do not inspect or construct cursors.

Each change includes stable ID, entity type, slug, timestamp, canonical and API paths, resource links, and locator fields. Subnational records include both countrySlug and slug; evidence summaries include compound and topic slugs. The feed currently covers published Sanity documents and upserts only. It does not emit deletion tombstones or revisions to code-backed compound timelines, so consumers should periodically reconcile full listings and treat timeline data as snapshot-only.

# First page
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/changes?since=2026-07-01T00:00:00Z"

# Continuation: use the exact opaque meta.cursor, without since
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/changes?cursor=OPAQUE_CURSOR"

Compound reports and timelines

The compounds list is a compact index. Pro keys can retrieve the full published compound report as structured JSON, including portable-text content, linked research, and timeline availability. Where a curated research-journey timeline is published, its milestones and programme threads are available from the timeline endpoint. Open-ended timeline acts use until: null with openEnded: true.

# Complete compound report, including timeline availability
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/compounds/psilocybin"

# Full curated research-journey timeline (published compounds only)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/compounds/psilocybin/timeline"

Topic reports and research evidence

Pro keys can also retrieve complete published topic reports and the evidence pages that connect a compound with an indication. The compound-topic endpoint returns its matched papers and trials alongside any published safety and dose summaries. The two summary endpoints return their complete underlying evidence rows.

# Complete topic report
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/topics/depression"

# Evidence for one compound and indication, with matching papers and trials
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/research/psilocybin/depression"

# Complete safety and dose evidence, where published
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/research/psilocybin/depression/adverse-events"
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/research/psilocybin/depression/dose-summaries"

DOI Lookup Flow

Use /api/v1/papers?doi=... to find a paper by DOI, then use the returned slug with /api/v1/papers/:slug for full detail.

# Bare DOI
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/papers?doi=10.1038/s41591-023-02565-4"

# DOI URL
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/papers?doi=https://doi.org/10.1038/s41591-023-02565-4"

# Then fetch full paper by slug
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.moreblossom.com/api/v1/papers/:slug"

Response Format

JSON responses follow a consistent envelope:

{
  "data": [ ... ],
  "meta": {
    "cursor": "abc123",
    "hasMore": true
  }
}

Code Examples

import requests

API_KEY = "your_api_key_here"  # From Account Settings → API Keys

headers = {"Authorization": f"Bearer {API_KEY}"}

# Filter by compound slug
resp = requests.get(
    "https://www.moreblossom.com/api/v1/papers",
    params={"compound": "psilocybin", "limit": 50},
    headers=headers,
)
papers = resp.json()["data"]

# Full-text search across titles and abstracts
resp = requests.get(
    "https://www.moreblossom.com/api/v1/papers",
    params={"q": "santo daime", "limit": 25},
    headers=headers,
)
papers = resp.json()["data"]

library(httr2)

# Store your API key in .Renviron: BLOSSOM_API_KEY=your_key_here
resp <- request("https://www.moreblossom.com/api/v1/papers") |>
  req_headers(Authorization = paste("Bearer", Sys.getenv("BLOSSOM_API_KEY"))) |>
  req_url_query(compound = "psilocybin", format = "csv") |>
  req_perform()

papers <- read.csv(textConnection(resp_body_string(resp)))

# Discover the current download URL (datasets are refreshed daily)
downloads <- request("https://www.moreblossom.com/api/v1/downloads") |>
  req_headers(Authorization = paste("Bearer", Sys.getenv("BLOSSOM_API_KEY"))) |>
  req_perform() |>
  resp_body_json()

files <- downloads$data
is_papers <- vapply(
  files,
  function(file) identical(file$filename, "papers-metadata.csv"),
  logical(1)
)
papers_url <- files[[which(is_papers)[1]]]$url
papers <- read.csv(papers_url, na.strings = "NA", fileEncoding = "UTF-8-BOM")

Downloadable Datasets

Pre-generated datasets are refreshed daily. Available in CSV (R/SPSS compatible) and JSON formats. Use the /api/v1/downloads endpoint to list all available files with download URLs.

Rate Limits