Access marketplace data programmatically. Search listings, browse categories, and integrate our marketplace into your applications.
# Get your API key from the dashboard, then:
curl -H "x-api-key: YOUR_API_KEY" \ https://marketplace.zambia.net/api/v1/listings?limit=10
All API requests require an API key passed via the x-api-key header.
Get your API key from the API Dashboard.
/api/v1/listingsSearch and browse active listings with filtering and pagination.
| Parameter | Type | Description |
|---|---|---|
| category | string | Filter by category slug |
| search | string | Search listings by title |
| minPrice | number | Minimum price filter |
| maxPrice | number | Maximum price filter |
| limit | number | Results per page (max 50, default 20) |
| offset | number | Pagination offset (default 0) |
curl -H "x-api-key: YOUR_API_KEY" \ "https://marketplace.zambia.net/api/v1/listings?category=electronics&search=laptop&limit=10"
{
"data": [
{
"id": "abc123",
"title": "Dell Laptop 16GB RAM",
"price": 8500,
"priceType": "NEGOTIABLE",
"location": "Lusaka",
"condition": "USED",
"viewsCount": 42,
"createdAt": "2026-04-01T10:00:00Z",
"category": { "name": "Electronics", "slug": "electronics" },
"image": { "url": "...", "thumbnailUrl": "..." },
"seller": { "name": "John", "isVerified": true }
}
],
"pagination": { "total": 145, "limit": 10, "offset": 0 }
}/api/v1/categoriesGet all categories with subcategories and listing counts.
curl -H "x-api-key: YOUR_API_KEY" \ "https://marketplace.zambia.net/api/v1/categories"
{
"data": [
{
"id": "cat123",
"name": "Electronics",
"slug": "electronics",
"icon": "...",
"listingCount": 234,
"subcategories": [
{ "id": "sub1", "name": "Phones", "slug": "electronics-phones" }
]
}
]
}API rate limits depend on your plan. Exceeding your rate limit will return a 429 status code.
| Plan | Calls/Month | Price |
|---|---|---|
| Starter API | 1,000 API calls/month | K500/mo |
| Business API | 10,000 API calls/month | K2,000/mo |
| Enterprise API | Unlimited API calls | K10,000/mo |
K500/month
K2,000/month
K10,000/month