Research API

Access the Blossom psychedelic research database programmatically. Papers, clinical trials, compounds, researchers, and co-authorship networks — available as JSON, CSV, and downloadable datasets for R, Python, and SPSS.

Quick Start

1. Create an API Key

Go to your Account Settings and create an API key. Copy it immediately — it's only shown once. Use the key in the Authorization header for all requests.

2. Make a request

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

3. Get CSV for R/SPSS

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

Endpoints

Method	Path	Description	Tier
GET	/api/v1/papers	List papers with metadata (paginated, filterable)	free
GET	/api/v1/papers/:slug	Single paper detail — Pro adds outcome measures & adverse events	free
GET	/api/v1/trials	List clinical trials (paginated, filterable)	free
GET	/api/v1/trials/:slug	Single trial detail — Pro adds arms, dosing, eligibility	free
GET	/api/v1/compounds	List compounds with trial/paper counts	free
GET	/api/v1/topics	List topics/indications with trial/paper counts	free
GET	/api/v1/persons	List researchers with affiliations	free
GET	/api/v1/journals	List journals with h-index	free
GET	/api/v1/network	Co-authorship network graph (nodes + edges)	pro
GET	/api/v1/evidence-matrix	Compound × topic evidence matrix	pro
GET	/api/v1/downloads	List available dataset files for download	free

Query Parameters

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

Parameter	Description
limit	Results per page (1–100, default 25)
cursor	Pagination cursor (use value from response meta.cursor)
q	Full-text search query — matches paper titles and abstracts (papers endpoint only)
doi	Filter by DOI (papers endpoint only). Accepts DOI path or DOI URL.
compound	Filter by compound slug (e.g., psilocybin)
topic	Filter by topic slug (e.g., depression)
since	Filter by date (ISO 8601, e.g., 2024-01-01)
format	Response format: json (default) or csv

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

Python

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"]

R (httr2)

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)))

R (download CSV)

# Download a pre-generated dataset (daily updated)
papers <- read.csv("https://www.moreblossom.com/api/v1/downloads/papers-metadata.csv",
                   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.

File	Description	Tier
papers-metadata.csv	All papers: DOI, PMID, title, date, study type, authors, compounds, topics	free
papers-outcomes.csv	Per-arm outcome measures: timepoints, estimates, CIs	pro
papers-contrasts.csv	Between-group contrasts: effect sizes, p-values	pro
papers-adverse-events.csv	Per-arm TEAE counts	pro
trials.csv	All trials: registry, phase, status, compound, sponsor	free
trials-detailed.csv	Trials with eligibility, therapy, sites	pro
persons.csv	Researchers with affiliations and paper/trial counts	free
compounds.csv	Compounds with pharmacology and counts	free
topics.csv	Indications with prevalence and counts	free
evidence-matrix.csv	Compound x topic evidence ratings	pro
network.json	Co-authorship network graph	pro

Rate Limits

Free

100

requests / minute

Pro

500