Altibbi APIaltibbi.com ↗
Access medicine and disease data from Altibbi's Arabic medical encyclopedia. Browse commercial and scientific drug listings, dosage, uses, and disease profiles.
What is the Altibbi API?
The Altibbi API exposes 4 endpoints covering medicine listings and detailed medical profiles from altibbi.com, one of the Arab world's largest medical encyclopedias. Use get_medicine_detail to retrieve 10 structured fields per drug — including uses, dosage, contraindications, and drug interactions — or use the listing endpoints to paginate through medicines alphabetically in both Arabic and English.
curl -X GET 'https://api.parse.bot/scraper/39da695f-dae4-47f7-9dbe-ab3018f10222/get_medicines_by_letter_commercial?page=1&letter=A' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace altibbi-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Altibbi Medical Encyclopedia — browse medicines and diseases."""
from parse_apis.altibbi_medical_encyclopedia_api import Altibbi, ResourceNotFound
client = Altibbi()
# List commercial medicines starting with 'A', capped at 5 items.
for med in client.commercialmedicines.list(letter="A", limit=5):
print(med.commercial_name_en, med.commercial_name_ar)
# Take one scientific medicine and drill into its full details.
sci = client.scientificmedicines.list(letter="B", limit=1).first()
if sci:
detail = sci.details()
print(detail.name, detail.manufacturer)
# Fetch a medicine directly by slug.
try:
medicine = client.medicines.get(slug="اموكسيسيلين")
print(medicine.name, medicine.uses[:80] if medicine.uses else "")
except ResourceNotFound as exc:
print(f"Medicine not found: {exc.slug}")
# Fetch a disease by slug.
disease = client.diseases.get(slug="السكري")
print(disease.title, disease.image_url)
print("exercised: commercialmedicines.list / scientificmedicines.list / details / medicines.get / diseases.get")
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.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| letterrequired | string | Starting letter to filter medicines. Accepts English letters (e.g. 'A', 'B') or Arabic letters (e.g. 'ب', 'ت'). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"last_page": "integer, total number of pages available",
"medicines": "array of medicine objects with commercial_name_en, commercial_name_ar, slug, url, and description",
"total_on_page": "integer, number of medicines returned on this page"
},
"sample": {
"data": {
"page": 1,
"last_page": 89,
"medicines": [
{
"url": "https://altibbi.com/الادوية/%D8%A2%D8%A8%D9%8A-%D9%81%D9%8A%D8%AA-%D8%A7",
"slug": "%D8%A2%D8%A8%D9%8A-%D9%81%D9%8A%D8%AA-%D8%A7",
"description": "",
"commercial_name_ar": "آبي فيت أ",
"commercial_name_en": "Abi Vit A"
}
],
"total_on_page": 20
},
"status": "success"
}
}About the Altibbi API
Medicine Listings by Letter
Two endpoints handle alphabetical browsing of the medicine catalog. get_medicines_by_letter_commercial accepts a letter parameter (Arabic or English) and returns up to 20 results per page, each with commercial_name_en, commercial_name_ar, slug, url, and a short description. get_medicines_by_letter_scientific works identically for generic drug names, returning scientific_name_en, scientific_name_ar, slug, and url. Both endpoints return page, last_page, and total_on_page fields so you can iterate through the full catalog programmatically.
Medicine Detail
get_medicine_detail accepts a slug obtained from either listing endpoint and returns the full drug profile: uses, dosage, how_to_use, precautions, contraindications, drug_interactions, manufacturer, and the canonical url. The slug can be URL-encoded Arabic text or an English string, as found in the listing results. This endpoint is the primary source for clinical reference data.
Disease and Medical Term Detail
get_disease_detail retrieves structured information for a disease or medical term using a slug (e.g. 'السكري'). An optional category parameter narrows the lookup; if omitted, the correct page is located automatically. The response includes title, image_url, breadcrumb (navigation path as an array of strings), url, and slug. This is useful for building condition-specific reference tools or linking drug profiles to relevant disease pages.
The Altibbi API is a managed, monitored endpoint for altibbi.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when altibbi.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official altibbi.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build an Arabic-language drug reference app using commercial and scientific name listings with full dosage and contraindication data.
- Populate a medicine database by paginating through all letters with the listing endpoints and resolving slugs to full profiles via
get_medicine_detail. - Cross-reference a drug's
drug_interactionsfield against a patient's current medications in a clinical decision-support tool. - Display disease overview cards using
get_disease_detailbreadcrumb andimage_urlfields in a patient education portal. - Index Altibbi's medical encyclopedia for full-text search by iterating listing results and fetching detail pages.
- Map commercial drug names to scientific generic names using both listing endpoints on the same letter.
- Generate condition-specific medication guides by linking
get_disease_detailslugs to relevantget_medicine_detailresults.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Altibbi have an official developer API?+
What does `get_medicine_detail` return that the listing endpoints don't?+
get_medicine_detail returns the full clinical profile: uses, dosage, how_to_use, precautions, contraindications, drug_interactions, and manufacturer. The listing endpoints return only names, slugs, URLs, and a short description — enough to identify medicines and build pagination, but not enough for clinical reference without fetching the detail endpoint.Can I search for medicines or diseases by keyword rather than browsing by letter?+
letter param), and get_disease_detail requires a known slug. There is no free-text keyword search endpoint currently. The API covers alphabetical browsing and slug-based detail retrieval. You can fork it on Parse and revise to add a search endpoint if keyword lookup is required.Does the disease detail endpoint return symptom lists or treatment protocols?+
get_disease_detail response includes title, image_url, breadcrumb, url, and slug. Structured symptom lists or treatment protocol fields are not currently part of the response. You can fork the API on Parse and revise it to add those fields if the disease pages on Altibbi expose that content.How does pagination work for the medicine listing endpoints?+
page (current page), last_page (total pages), and total_on_page (count on the current page), with 20 medicines per page. Pass the page integer parameter to step through results. If page is omitted, the first page is returned by default.