Pricing API Documentation

This API is available at:

POST https://www.promptbox.cn/api/price.php

The API calculates sales and pricing scenarios for business decision-making. Two modes are supported:

Request

Requests must be sent with Content-Type: application/json.

Base Parameters

Parameter Type Required Description
mode string Yes "NP" (Low Price Justification) or "NB" (New Business Pricing)
ef number Yes Existing Forecast (pcs)
ep number Yes Existing Price
c number Yes Product Cost

Mode-Specific Parameters

When mode = "NP"

Parameter Type Required Description
lp number Yes New (lower) Price

When mode = "NB"

Parameter Type Required Description
nb number Yes Expected new business sales (pcs)
po number Yes Business overlap percentage (0–100)

Response

Responses are returned in JSON.

Success Response (mode = NP)

{
  "mode": "NP",
  "minimum_additional_sales": 250,
  "message": "Minimum additional sales needed to justify this price: 250 pcs"
}

Success Response (mode = NB)

{
  "mode": "NB",
  "lowest_price": 8.735,
  "additional_sales_threshold": 400,
  "message": "Lowest price to equalize profit: $8.735. If you can't get more than 400 additional, non-overlap, sales with this price, don't lower your price."
}

Error Response

{
  "error": "Missing required fields: ef, ep, c"
}

Example Requests

Example 1: Low Price Justification (NP)

POST https://www.promptbox.cn/api/price.php
Content-Type: application/json

{
  "mode": "NP",
  "ef": 1000,
  "ep": 12,
  "c": 7,
  "lp": 9
}

Example 2: New Business Pricing (NB)

POST https://www.promptbox.cn/api/price.php
Content-Type: application/json

{
  "mode": "NB",
  "ef": 1000,
  "ep": 12,
  "c": 7,
  "nb": 500,
  "po": 20
}

Notes