# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-altibbi-com-api-3cf539fe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-altibbi-com-api-3cf539fe/get_disease_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-altibbi-com-api-3cf539fe/get_medicine_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-altibbi-com-api-3cf539fe/get_medicines_by_letter_commercial \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-altibbi-com-api-3cf539fe/get_medicines_by_letter_scientific \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>","page":"<integer>"}'
```