Zambia.net Marketplace API

Access marketplace data programmatically. Search listings, browse categories, and integrate our marketplace into your applications.

Quick Start

# 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

Authentication

All API requests require an API key passed via the x-api-key header.

x-api-key: zmkt_your_api_key_here

Get your API key from the API Dashboard.

Endpoints

GET/api/v1/listings

Search and browse active listings with filtering and pagination.

Query Parameters

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)

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://marketplace.zambia.net/api/v1/listings?category=electronics&search=laptop&limit=10"

Example Response

{
  "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 }
}

GET/api/v1/categories

Get all categories with subcategories and listing counts.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://marketplace.zambia.net/api/v1/categories"

Example Response

{
  "data": [
    {
      "id": "cat123",
      "name": "Electronics",
      "slug": "electronics",
      "icon": "...",
      "listingCount": 234,
      "subcategories": [
        { "id": "sub1", "name": "Phones", "slug": "electronics-phones" }
      ]
    }
  ]
}

Rate Limits

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

API Plans

Starter API

K500/month

1,000 API calls/month
Read-only access
Listing search & browse
Category data

Get Started

Business API

K2,000/month

10,000 API calls/month
Read + Write access
Bulk listing upload
Inventory sync
Webhook notifications

Get Started

Enterprise API

K10,000/month

Unlimited API calls
Full read/write access
Real-time webhooks
Dedicated support
Custom endpoints
SLA guarantee

Get Started

Ready to integrate?

Get your API key from your dashboard and start building.

Get API Key