Skip to content

Search Medications

Search Medications

Search for medications across 1000+ pharmacies. Find what’s available, compare prices, and locate the nearest pharmacy that has your medication in stock.

Find Nearby Pharmacies

Search for pharmacies near a location that stock a specific medication.

Terminal window
# Find pharmacies with Amoxicillin in Lagos
find_nearby_pharmacy({
medication: "Amoxicillin 500mg",
location: "Lagos",
radius: 10 // kilometers (optional)
})

Parameters:

ParameterTypeRequiredDescription
medicationstringYesMedication name or generic name
locationstringYesCity, area, or address
radiusnumberNoSearch radius in km (default: 10)

Response:

{
"pharmacies": [
{
"id": "PH-456",
"name": "GreenCross Pharmacy",
"address": "12 Admiralty Way, Lekki, Lagos",
"distance": 2.3,
"phone": "+2348012345678",
"hours": "8AM - 10PM",
"inStock": true,
"price": 2500
},
{
"id": "PH-789",
"name": "HealthPlus Pharmacy",
"address": "45 Ozumba Mbadiwe, Victoria Island",
"distance": 5.1,
"phone": "+2348098765432",
"hours": "24 hours",
"inStock": true,
"price": 2300
}
]
}

Search Medications

Search for medications by name, condition, or category.

Terminal window
# Search for diabetes medications
search_medications({
query: "diabetes medication",
category: "chronic", // optional
page: 1,
limit: 20
})

Parameters:

ParameterTypeRequiredDescription
querystringYesSearch term (name, condition, etc.)
categorystringNoFilter by category (chronic, acute, otc)
pagenumberNoPage number for pagination
limitnumberNoResults per page (max: 50)

Response:

{
"medications": [
{
"id": "MED-123",
"name": "Metformin 500mg",
"generic": "Metformin Hydrochloride",
"category": "chronic",
"description": "For type 2 diabetes management",
"requiresPrescription": true
},
{
"id": "MED-124",
"name": "Insulin Glargine",
"generic": "Insulin",
"category": "chronic",
"description": "Long-acting insulin",
"requiresPrescription": true
}
],
"total": 45,
"page": 1,
"hasMore": true
}

Get Medication Details

Get comprehensive information about a specific medication.

Terminal window
# Get full details for a medication
get_medication_details({
stockId: "MED-123"
})

Parameters:

ParameterTypeRequiredDescription
stockIdstringYesMedication ID from search results

Response:

{
"id": "MED-123",
"name": "Amoxicillin 500mg Capsules",
"generic": "Amoxicillin",
"manufacturer": "Emzor Pharmaceuticals",
"form": "Capsule",
"strength": "500mg",
"packSize": "24 capsules",
"category": "antibiotic",
"description": "Broad-spectrum antibiotic for bacterial infections",
"usage": "Take 1 capsule 3 times daily after meals",
"sideEffects": ["Nausea", "Diarrhea", "Rash"],
"warnings": ["Penicillin allergy", "Complete full course"],
"requiresPrescription": true,
"priceRange": {
"min": 1500,
"max": 3000
}
}

Example: Complete Search Flow

Terminal window
# Step 1: Search for medication
search_medications({ query: "malaria" })
# → Returns list of antimalarial drugs
# Step 2: Get detailed info
get_medication_details({ stockId: "MED-456" })
# → Returns full medication details
# Step 3: Find nearby pharmacies
find_nearby_pharmacy({
medication: "Artemether-Lumefantrine",
location: "Ikeja, Lagos"
})
# → Returns pharmacies with stock
  • Use generic names (e.g., “Paracetamol” instead of “Panadol”)
  • Search by condition (e.g., “malaria”, “diabetes”, “hypertension”)
  • Check requiresPrescription before ordering
  • Compare prices across multiple pharmacies

Next steps