API Reference

Complete reference for the Peptide Injections REST API v1. All endpoints return JSON. Authenticate with your API key via the Authorization header.

Authentication

Every request must include your API key. Two methods are supported:

# Option 1: Authorization header (recommended)
curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  https://peptideinjections.ai/api/v1/providers

# Option 2: x-api-key header
curl -H "x-api-key: pk_live_YOUR_KEY" \
  https://peptideinjections.ai/api/v1/providers

Rate Limits

Tier	Daily Limit	Research Access
Free	100	No
Starter	5,000	No
Pro	50,000	Yes
Enterprise	Unlimited	Yes

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included on every response.

Response Format

All successful responses follow this envelope:

{
  "data": { ... },
  "meta": {
    "total": 418,
    "limit": 20,
    "offset": 0,
    "tier": "starter"
  }
}

Errors return:

{
  "error": {
    "message": "Description of what went wrong",
    "status": 401
  }
}

Endpoints

GET/api/v1/providers

List providers with optional filters. Sorted by Google rating (highest first). Supports pagination.

Parameters

Name	Type	Description
state	string	2-letter US state code (e.g. TX, CA)
type	string	Provider type: Telehealth, Clinic, Wellness Center, Pharmacy
specialty	string	Filter by specialty (e.g. "Weight Loss")
search	string	Free-text search across name, bio, description
telehealth	boolean	Filter to telehealth-only providers
limit	integer	Results per page (default 20, max 100)
offset	integer	Pagination offset (default 0)

Example Request

curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  "https://peptideinjections.ai/api/v1/providers?state=TX&telehealth=true&limit=5"

Example Response

{
  "data": [
    {
      "id": "abc-123",
      "name": "Defy Medical",
      "slug": "defy-medical",
      "type": "Telehealth",
      "city": "Tampa",
      "state": "FL",
      "website": "https://defymedical.com",
      "telehealth": true,
      "description": "...",
      "specialties": ["Hormone Therapy", "Peptide Therapy"]
    }
  ],
  "meta": { "total": 171, "limit": 5, "offset": 0, "tier": "free" }
}

GET/api/v1/providers/:slug

Get a single provider by slug or UUID. Returns full data based on your tier.

Parameters

Name	Type	Description
slug*	string	Provider slug or UUID

Example Request

curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  "https://peptideinjections.ai/api/v1/providers/defy-medical"

Example Response

{
  "data": {
    "id": "abc-123",
    "name": "Defy Medical",
    "slug": "defy-medical",
    "type": "Telehealth",
    "bio": "Defy Medical is a leader in telemedicine...",
    "google_rating": 4.8,
    "google_review_count": 342,
    "...": "..."
  },
  "meta": { "tier": "starter" }
}

GET/api/v1/peptides

List all indexed peptides with optional category and FDA status filters.

Parameters

Name	Type	Description
category	string	Peptide category (e.g. "weight-loss", "tissue-repair")
fda_status	string	FDA status filter (e.g. "FDA-approved", "Investigational")
search	string	Free-text search across name, description, mechanism
limit	integer	Results per page (default 50, max 100)
offset	integer	Pagination offset (default 0)

Example Request

curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  "https://peptideinjections.ai/api/v1/peptides?category=weight-loss"

Example Response

{
  "data": [
    {
      "id": "abc-456",
      "name": "Semaglutide",
      "slug": "semaglutide",
      "category": "Weight Loss & GLP-1",
      "fda_status": "FDA-approved",
      "evidence_level": "Strong Clinical Evidence",
      "description": "...",
      "mechanism": "..."
    }
  ],
  "meta": { "total": 16, "limit": 50, "offset": 0, "tier": "free" }
}

GET/api/v1/peptides/:slug

Get a single peptide by slug with full details (FAQ, key studies, etc. on Starter+).

Parameters

Name	Type	Description
slug*	string	Peptide slug

Example Request

curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  "https://peptideinjections.ai/api/v1/peptides/bpc-157"

Example Response

{
  "data": {
    "name": "BPC-157",
    "slug": "bpc-157",
    "category": "Tissue Repair & Healing",
    "fda_status": "Investigational",
    "mechanism": "Body Protection Compound that...",
    "studies_total": 847,
    "studies_human": 12,
    "faq": { "What is BPC-157?": "..." },
    "key_studies": [...]
  },
  "meta": { "tier": "starter" }
}

GET/api/v1/research/:peptidePro+

Aggregated research data from OpenFDA, PubMed, and ClinicalTrials.gov. Requires Pro tier or above.

Parameters

Name	Type	Description
peptide*	string	Peptide slug (e.g. semaglutide, bpc-157)

Example Request

curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  "https://peptideinjections.ai/api/v1/research/semaglutide"

Example Response

{
  "data": {
    "peptide": "semaglutide",
    "fda": { "labels": [...], "adverseEvents": {...} },
    "pubmed": { "totalResults": 5420, "articles": [...] },
    "clinicalTrials": { "totalCount": 312, "studies": [...] },
    "sources": { "openfda": "...", "pubmed": "...", "clinicalTrials": "..." }
  },
  "meta": { "tier": "pro" }
}

GET/api/v1/categories

List all peptide categories with descriptions.

Example Request

curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  "https://peptideinjections.ai/api/v1/categories"

Example Response

{
  "data": [
    { "id": "...", "name": "Weight Loss & GLP-1", "slug": "weight-loss", "description": "..." },
    { "id": "...", "name": "Tissue Repair & Healing", "slug": "tissue-repair", "description": "..." }
  ],
  "meta": { "tier": "free" }
}

GET/api/v1/search

Unified search across both providers and peptides.

Parameters

Name	Type	Description
q*	string	Search query (min 2 chars)
limit	integer	Max results per type (default 10, max 50)

Example Request

curl -H "Authorization: Bearer pk_live_YOUR_KEY" \
  "https://peptideinjections.ai/api/v1/search?q=semaglutide"

Example Response

{
  "data": {
    "providers": [...],
    "peptides": [...],
    "query": "semaglutide"
  },
  "meta": { "tier": "starter" }
}

Embeddable Widget

Add a searchable provider or peptide directory to any website with one line of code:

<script src="https://peptideinjections.ai/widget.js"
  data-api-key="pk_live_YOUR_KEY"
  data-type="providers"
  data-theme="light"
  data-state="TX"
  data-limit="8">
</script>

Widget Options

Attribute	Default	Description
data-api-key	(required)	Your API key
data-type	providers	"providers", "peptides", or "search"
data-theme	light	"light" or "dark"
data-accent	#6366f1	Accent color hex
data-limit	6	Number of results to show
data-state		2-letter state filter (providers only)
data-category		Category filter (peptides only)
data-max-height	600px	Max widget height