# Examine — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and explore evidence-based information about supplements, health conditions, and outcomes with detailed supplement profiles, study summaries, and categorized health data. Get comprehensive overviews of how specific supplements affect various health conditions backed by scientific research.

**Category:** Healthcare | **Website:** [examine.com/](https://examine.com/) | **Docs:** [parse.bot/marketplace/25ad5809-1464-4116-965c-6465fbad834c/examine-com-api](https://parse.bot/marketplace/25ad5809-1464-4116-965c-6465fbad834c/examine-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_health_category

Get details and associated conditions for a specific health category. Returns the category title and a list of conditions within that category, each with name and slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Category slug from list_health_categories results (e.g., 'brain-health', 'cardiovascular-health', 'mental-health'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/get_health_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_health_condition

Get title and description for a specific health condition. The description is derived from the page's meta description, providing a concise summary of the condition.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Condition slug from list_conditions or get_health_category results (e.g., 'depression', 'insomnia', 'acne'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/get_health_condition \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_study_summary

Get the full content for a specific guide hosted on Examine.com, including the title and text body. Guides cover topics like how to read a study, protein intake, and other educational health content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Guide slug from Examine.com guide URLs (e.g., 'how-to-read-a-study', 'protein-intake'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/get_study_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_supplement_overview

Get comprehensive details for a specific supplement including summary, research snapshot (reference/trial/participant counts), dosage information, safety notes, and evidence grades (A-D letter grades for studied outcomes). Requires the supplement slug from list_supplements.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Supplement slug from list_supplements results (e.g., 'vitamin-d', 'creatine', 'ashwagandha'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/get_supplement_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_conditions

List all health conditions available on Examine.com. No pagination; returns the full conditions directory in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/list_conditions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_health_categories

List all health categories available on Examine.com (e.g., Brain Health, Cardiovascular Health, Mental Health). No pagination; returns the full category directory in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/list_health_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_outcomes

List all health outcomes tracked on Examine.com. No pagination; returns the full outcomes directory in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/list_outcomes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_supplements

List all available supplements from the Examine.com directory. Returns supplement names, URLs, and slugs. No pagination; returns the full directory in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/list_supplements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search

Full-text search across Examine.com content including supplements, conditions, outcomes, guides, and categories. Returns matching results with type classification. Results are not paginated; the server returns a single page of top matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'creatine', 'vitamin d', 'immunity'). |
| `type_filter` | string | No | Filter results by type. Passed as the 'type' query parameter to the search page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-examine-com-api-25ad5809/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","type_filter":"<string>"}'
```