Soko24 Developer API

Embed any seller's products and services directly into your own website or mobile app. No authentication required for public catalog endpoints.

Base URL: https://soko24.co/api/v2
Rate Limit: 60 requests/minute per IP for catalog endpoints.

Seller Catalog API

Returns a unified catalog of a seller's products and services in a single response. Perfect for sellers who want to display their Soko24 inventory on their own site.

GET /shops/catalog/{id}

Parameters

id (required) — Shop ID or slug
product_category (optional) — Filter products by category ID
product_search (optional) — Search products by name
product_per_page (optional) — Default: 12
product_page (optional) — Page number
service_category (optional) — Filter services by category ID
service_search (optional) — Search services by title
service_per_page (optional) — Default: 12
service_page (optional) — Page number

Example Request

curl "https://soko24.co/api/v2/shops/catalog/my-shop-slug?product_per_page=6"

Example Response

{
  "success": true,
  "status": 200,
  "shop": {
    "id": 42,
    "name": "Aguma Electronics",
    "logo": "https://soko24.co/public/uploads/all/...",
    "rating": 4.8,
    "verified": true,
    "address": "Kampala, Uganda"
  },
  "products": {
    "data": [ ... ],
    "pagination": {
      "total": 45,
      "per_page": 12,
      "current_page": 1,
      "last_page": 4
    }
  },
  "services": {
    "data": [ ... ],
    "pagination": {
      "total": 8,
      "per_page": 12,
      "current_page": 1,
      "last_page": 1
    }
  }
}

Other Public Endpoints

Method	Endpoint	Description
GET	`/v2/shops`	List all verified sellers
GET	`/v2/shops/details/{id}`	Shop details by ID or slug
GET	`/v2/shops/products/all/{id}`	All published products for a shop
GET	`/v2/services`	Service marketplace listing
GET	`/v2/service/{slug}`	Single service detail

📄 Download Full API Docs (Markdown)