Products

Product catalog and search

Get products by category

get

http://localhost:8009/api/v3https://cherrymails.com/api/v3

/categories/{categoryId}/products

Retrieve products for a specific category

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from login or register endpoint

Path parameters

categoryIdintegerRequired

Category ID

Example: 1

Query parameters

langstringOptional

Language code

Default: en

pageintegerOptional

Page number

Default: 1

limitinteger · max: 100Optional

Items per page

Default: 20

Responses

200

Products retrieved successfully

application/json

get

/categories/{categoryId}/products

HTTPcURLJavaScriptPython

GET /api/v3/categories/{categoryId}/products HTTP/1.1
Host: localhost:8009
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Products retrieved successfully

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 1,
        "code": 1001,
        "category_id": 5,
        "category_name": "Gmail Accounts",
        "name": "Gmail PVA Account",
        "description": "Phone verified Gmail account",
        "price": 10,
        "discount_price": 8.5,
        "final_price": 8.5,
        "stock": 100,
        "in_stock": true,
        "image_url": "/img/products/gmail.jpg",
        "autostock_enabled": true
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 100,
      "total_pages": 5
    }
  }
}

Get product details

get

http://localhost:8009/api/v3https://cherrymails.com/api/v3

/products/{productCode}

Retrieve detailed information about a product

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from login or register endpoint

Path parameters

productCodeintegerRequired

Product code

Example: 1001

Query parameters

langstringOptional

Language code

Default: en

Responses

200

Product retrieved successfully

application/json

404

Product not found

application/json

get

/products/{productCode}

HTTPcURLJavaScriptPython

GET /api/v3/products/{productCode} HTTP/1.1
Host: localhost:8009
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "product": {
      "id": 1,
      "code": 1001,
      "category_id": 5,
      "category_name": "Gmail Accounts",
      "name": "Gmail PVA Account",
      "description": "Phone verified Gmail account",
      "price": 10,
      "discount_price": 8.5,
      "final_price": 8.5,
      "stock": 100,
      "in_stock": true,
      "image_url": "/img/products/gmail.jpg",
      "autostock_enabled": true
    }
  }
}

Search products

get

http://localhost:8009/api/v3https://cherrymails.com/api/v3

/products/search

Search for products by name or description

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from login or register endpoint

Query parameters

qstring · min: 2Required

Search query (minimum 2 characters)

Example: gmail

langstringOptional

Language code

Default: en

pageintegerOptional

Page number

Default: 1

limitintegerOptional

Items per page

Default: 20

Responses

200

Search completed successfully

application/json

get

/products/search

HTTPcURLJavaScriptPython

GET /api/v3/products/search?q=gmail HTTP/1.1
Host: localhost:8009
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Search completed successfully

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 1,
        "code": 1001,
        "category_id": 5,
        "category_name": "Gmail Accounts",
        "name": "Gmail PVA Account",
        "description": "Phone verified Gmail account",
        "price": 10,
        "discount_price": 8.5,
        "final_price": 8.5,
        "stock": 100,
        "in_stock": true,
        "image_url": "/img/products/gmail.jpg",
        "autostock_enabled": true
      }
    ],
    "query": "text",
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 100,
      "total_pages": 5
    }
  }
}