[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [NIH DSLD supplement label search](https://spiral.ai/integrations/codex/nih-dsld-supplement-label-search)

# How to Use NIH DSLD supplement label search in Codex

Returns supplement labels matching search terms and filters, including barcode searches. Use it to find products by text anywhere on the label, then fetch individual records for ingredient amounts.

|  |  |
| --- | --- |
| Model | NIH DSLD supplement label search |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with NIH DSLD supplement label search in Codex

- Use NIH DSLD supplement label search to find Centrum Silver Men 50+ records and add a product-matching report to this project with each returned label's ID and market status.
- Use NIH DSLD supplement label search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from NIH DSLD supplement label search and tell me what changed since last week.
- Check NIH DSLD supplement label search and summarize what you find in three bullet points.
- Pull the newest data from NIH DSLD supplement label search and give me the result as a table.

## How to set up NIH DSLD supplement label search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run NIH DSLD supplement label search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "dsld-od-nih-gov/dietary-supplement-labels/search_labels",
    "input": {
      "sort": "relevance"
    }
  }'
```

Then paste one of the prompts above: Codex finds NIH DSLD supplement label search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## NIH DSLD supplement label search tools and prices

- [NIH Dietary Supplement Label Database (dsld.od.nih.gov) · Search labels](https://spiral.ai/tools/alexandria/dsld-od-nih-gov/dietary-supplement-labels/search_labels) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort | relevance, newest, oldest, name_asc, name_desc | — | `relevance` (default for a term query), `newest` (default for `*`), `oldest`, `name_asc`, `name_desc` |
| brand |  | — | Exact brand name filter (DSLD `brand`) |
| query |  | * | Search terms; `*` matches every label (default). Elasticsearch simple query syntax: quote a phrase or UPC. |
| offset | 0 to … | 0 | Zero-based offset of the first hit; pass `next_offset` from the previous page |
| status | all, on_market, off_market | all | Market status: `all` (DSLD status=2, default), `on_market` (status=1) or `off_market` (status=0) |
| page_size | 1 to 100 | 20 | Hits per page (1-100) |

## What can you do with NIH DSLD supplement label search in Codex?

Build a supplement catalog that connects brand names, ingredient groups, and individual label records. Use DSLD's U.S. label data to populate product comparisons with printed serving sizes, ingredients, and statements.

### Match a retailer's supplement catalog

Resolve brand spellings, locate product records, and attach the corresponding DSLD label to each matched catalog entry. Compare the printed ingredients and statements with the retailer's descriptions.

### Research an ingredient across brands

Resolve an ingredient's alternate names, find matching labels, and compare amounts per serving across recorded brands. Use database counts to describe the scope of the extract.

### Compare historical label formulations

Collect current and off-market records for a named product or brand, then compare ingredient forms, amounts, and label statements. Describe differences between the available records without assuming a complete formulation history.

### Build a supplement label research dataset

Define the product categories to study, resolve brand and ingredient names, and collect matching label records. Keep printed serving sizes and ingredient units attached to the extracted amounts.

### Reconcile brand names in a product database

Compare imported brand names with DSLD's directory and inspect associated product listings before accepting a match. Use product names to review ambiguous brand matches.

### Audit claims printed on supplement labels

Select a product category and brand set, then collect label claims alongside ingredient details. Prepare an evidence table for editorial or regulatory review, with each statement attributed to its label.

### Measure coverage before starting a study

Check database counts, inspect brand and product directories, and resolve the study's ingredient terms. Run sample searches to determine whether DSLD contains enough relevant records for the proposed analysis.

### Compare supplement forms within an ingredient category

Find products for an ingredient such as vitamin D and organize the available records by supplement form. Open individual labels to compare serving sizes, ingredient forms, and amounts.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## NIH DSLD supplement label search in other agents

- [Amp](https://spiral.ai/integrations/amp/nih-dsld-supplement-label-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/nih-dsld-supplement-label-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/nih-dsld-supplement-label-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/nih-dsld-supplement-label-search)
- [Cline](https://spiral.ai/integrations/cline/nih-dsld-supplement-label-search)
- [Cursor](https://spiral.ai/integrations/cursor/nih-dsld-supplement-label-search)
- [Devin](https://spiral.ai/integrations/devin/nih-dsld-supplement-label-search)
- [dots](https://spiral.ai/integrations/dots/nih-dsld-supplement-label-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/nih-dsld-supplement-label-search)
- [Gemini](https://spiral.ai/integrations/gemini/nih-dsld-supplement-label-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/nih-dsld-supplement-label-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/nih-dsld-supplement-label-search)
- [goose](https://spiral.ai/integrations/goose/nih-dsld-supplement-label-search)
- [Grok](https://spiral.ai/integrations/grok/nih-dsld-supplement-label-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/nih-dsld-supplement-label-search)
- [Hermes](https://spiral.ai/integrations/hermes/nih-dsld-supplement-label-search)
- [Instinct](https://spiral.ai/integrations/instinct/nih-dsld-supplement-label-search)
- [Manus](https://spiral.ai/integrations/manus/nih-dsld-supplement-label-search)
- [Muse](https://spiral.ai/integrations/muse/nih-dsld-supplement-label-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/nih-dsld-supplement-label-search)
- [n8n](https://spiral.ai/integrations/n8n/nih-dsld-supplement-label-search)
- [Notion](https://spiral.ai/integrations/notion/nih-dsld-supplement-label-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/nih-dsld-supplement-label-search)
- [opencode](https://spiral.ai/integrations/opencode/nih-dsld-supplement-label-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/nih-dsld-supplement-label-search)
- [Raycast](https://spiral.ai/integrations/raycast/nih-dsld-supplement-label-search)
- [VS Code](https://spiral.ai/integrations/vscode/nih-dsld-supplement-label-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/nih-dsld-supplement-label-search)
- [Zapier](https://spiral.ai/integrations/zapier/nih-dsld-supplement-label-search)

## More Codex guides

- [NIH DSLD supplement label details](https://spiral.ai/integrations/codex/nih-dsld-supplement-label-details)
- [Newegg open-box listings](https://spiral.ai/integrations/codex/newegg-open-box-listings)
- [NIH DSLD product directory](https://spiral.ai/integrations/codex/nih-dsld-product-directory)
- [Newegg product details](https://spiral.ai/integrations/codex/newegg-product-details)
- [NIH DSLD ingredient groups](https://spiral.ai/integrations/codex/nih-dsld-ingredient-groups)
- [Newegg product reviews](https://spiral.ai/integrations/codex/newegg-product-reviews)

## Questions about NIH DSLD supplement label search in Codex

**Can Codex use NIH DSLD supplement label search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run NIH DSLD supplement label search like any built-in tool.

**How much does NIH DSLD supplement label search cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use NIH DSLD supplement label search in Codex?**

No. Spiral runs NIH DSLD supplement label search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up NIH DSLD supplement label search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while NIH DSLD supplement label search runs?**

NIH DSLD supplement label search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Which market does DSLD cover?**

DSLD covers dietary supplement labels for products sold in the United States. Foods and nutrition products without dietary supplement labeling are generally excluded.

**Does DSLD contain every supplement sold in the United States?**

DSLD aims to collect labels across the U.S. supplement market, but its collection draws on surveys and voluntary manufacturer submissions. A missing record does not establish that a product is unavailable.

**How fresh are the label records?**

NIH describes regular updates for new products and changes to existing labels. The published description does not specify a fixed daily or weekly update interval.

**Why do discontinued products appear?**

DSLD deliberately retains labels for products both on and off the market. Its historical records support research into previously sold supplements.

**Does inclusion mean NIH verified the label?**

No. ODS does not verify that labels comply with FDA regulations and legal requirements, so inclusion is not a compliance finding.

