# Examine — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/examine/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/examine/get-health-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/get-health-condition \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/get-study-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/get-supplement-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/list-conditions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/list-health-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/list-outcomes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/list-supplements \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/examine/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","type_filter":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.