# NCBI BioSample E-Search

> NCBI BioSample E-Search is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status down (last checked 2026-09-15).

Search NCBI BioSample database and return matching sample UIDs using NCBI E-utilities for a given query string

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/ncbi-esearch-biosample
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ncbi-biosample-e-search-456a1b6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XX4daQQTRR8MuF0EI2Grv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ncbi-biosample-e-search-456a1b6f -d '<json body>'
```

Example prompt: Search NCBI BioSample for samples matching 'Homo sapiens liver RNA-seq' and give me the matching sample UIDs.

## When to prefer this

Use this endpoint when you need to programmatically search the NCBI BioSample database to retrieve sample UIDs for downstream biological data retrieval workflows, particularly when building bioinformatics pipelines that require BioSample identifiers as input for further NCBI E-utilities calls.

## Known failure modes

- Empty result set if query matches no BioSample records
- Malformed query string may return zero results or NCBI error
- NCBI rate limiting or service unavailability returning error response
- Query too broad returning truncated result set
- Invalid special characters in query causing parse errors

## How this service works

Search NCBI BioSample and return matching sample UIDs for query {q} via E-utilities. Query: ?q= Returns JSON.

## Output

A JSON response containing BioSample UIDs (unique identifiers) matching the provided search query, along with result count metadata from NCBI E-utilities esearch endpoint.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ncbi-biosample-e-search-456a1b6f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)