# Altibbi — 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 browse comprehensive medicine and disease information from Altibbi's medical encyclopedia using commercial or scientific names. Get detailed profiles including dosage, uses, side effects, and disease descriptions to support healthcare decisions and medical research.

**Category:** Healthcare | **Website:** [altibbi.com/](https://altibbi.com/) | **Docs:** [parse.bot/marketplace/3cf539fe-416e-4b99-a6b5-70e7218e8870/altibbi-com-api](https://parse.bot/marketplace/3cf539fe-416e-4b99-a6b5-70e7218e8870/altibbi-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/altibbi/`
**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 disease detail

Retrieve full details for a specific disease or medical term. Provide the slug, and optionally the category. If category is not provided, the correct URL is found automatically via search. Returns the disease title, breadcrumb navigation, image, and all content sections as key-value pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug if known (e.g. 'مرض-السكري'). If not provided, the correct URL is found automatically via search. |
| `slug` | string | Yes | Disease/medical term URL slug (e.g. 'السكري', 'سكري-الحمل'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/altibbi/get-disease-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","slug":"<string>"}'
```

### Get medicine detail

Retrieve full details for a specific medicine by its URL slug. Returns comprehensive information including uses, dosage, contraindications, precautions, drug interactions, pharmaceutical forms, and manufacturer. The slug can be obtained from get_medicines_by_letter_commercial or get_medicines_by_letter_scientific results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Medicine URL slug from listing results (e.g. 'اموكسيسيلين'). Accepts both percent-encoded and Arabic text forms. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/altibbi/get-medicine-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get medicines by letter commercial

Get commercial medicine listings by their starting Arabic or English letter. Returns paginated results with 20 medicines per page. Each item includes the commercial name in Arabic and English plus a slug for fetching full details via get_medicine_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | Yes | Starting letter to filter medicines. Accepts English letters (e.g. 'A', 'B') or Arabic letters (e.g. 'ب', 'ت'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/altibbi/get-medicines-by-letter-commercial \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>","page":"<integer>"}'
```

### Get medicines by letter scientific

Get scientific (generic) medicine listings by their starting letter. Returns paginated results with 20 medicines per page. Each item includes the scientific name in Arabic and English plus a slug for fetching full details via get_medicine_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | Yes | Starting letter to filter medicines. Accepts English letters (e.g. 'A', 'B') or Arabic letters (e.g. 'ب', 'ت'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/altibbi/get-medicines-by-letter-scientific \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>","page":"<integer>"}'
```

## Next steps

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