What are you looking for?

📖 API Documentation — Partner API v1

Authentication: pass your API key as ?api_key=YOUR_KEY or header X-API-KEY. Keys are issued to admin-approved companies only.

1. List categories

GET /partners/api/v1/categories/?api_key=YOUR_KEY

2. Fetch ads category-wise

GET /partners/api/v1/ads/?api_key=YOUR_KEY&category=mobile-phones&location=dhaka&q=iphone&page=1

Response:
{
  "ok": true, "total": 124, "page": 1, "per_page": 20,
  "ads": [
    {"id": 1, "title": "iPhone 14 256GB", "price": 46000.0,
     "category": {"slug": "mobile-phones", "name_en": "Mobile Phones", "name_bn": "মোবাইল ফোন"},
     "location": {"slug": "dhaka", "name_en": "Dhaka", "name_bn": "ঢাকা"},
     "url": "/ad/iphone-14-256gb-ab12cd34/"}
  ]
}

3. Push your product (needs Push permission from admin)

POST /partners/api/v1/ads/push/
X-API-KEY: YOUR_KEY
Content-Type: application/json

{"title": "Samsung Galaxy S24", "description": "Official warranty",
 "price": 95000, "category": "mobile-phones", "location": "dhaka",
 "condition": "NEW", "phone": "01700000000"}

→ Ad is created with status PENDING and published after admin approval.

Error codes

401 Invalid API key · 403 Company not approved / permission not granted · 400 Bad payload