Smart Dynamic Pricing API
Dynamic Pricing with a Single Call
Smart Dynamic Pricing API
Dynamic Pricing with a Single Call
The API accepts your sales history, item costs, and other optional business metrics.
Our pricing model processes this information for each of your items.
It then returns a set of optimized prices designed to maximize your overall profitability.
The model learns over time. While initial optimizations can be effective, the system reaches its full potential after a few weeks of consistent data feeds, as it discovers market nuances and customer behavior patterns.
Obtain Credentials: To get started, you will need a user and pass for authentication. Please contact us through our contact form to set up your account.
Gather Your Data: Prepare your sales and cost data according to the payload structure defined below. The more accurate and complete the data, the better the optimization.
Make an API Call: Send the data as a JSON payload in a POST request to our API endpoint. Use one of our code examples below to get started quickly.
Implement New Prices: The API will return a list of optimized prices. Use this response to update the pricing in your e-commerce platform or sales system.
Automate: For best results, set up a recurring task (e.g., a cron job) to call the API every hour.
The API has a single endpoint for all operations:
URL: https://api.honama.dev/
Method: POST
Content-Type: application/json
Rate Limit: To ensure optimal performance for all users, API calls are limited.
A minimum of 30 minutes must pass between subsequent calls from the same user.
We recommend a regular hourly call schedule.
Payload Limit: The maximum size of the JSON payload is 32 MB.
If your sales data exceeds this limit, please send it in separate API calls, ensuring each call contains a complete and distinct set of items.
The body of your POST request must be a JSON object containing the following fields:
The API responds with a JSON object. The structure of the object depends on whether the request was successful or resulted in an error.
A successful API call returns a JSON object containing the optimized prices and supplementary data for the processed items.
The API responds with a JSON object. The structure of the object depends on whether the request was successful or resulted in an error.
A successful API call returns a JSON object containing the optimized prices and supplementary data for the processed items.
item_price_new (object): Contains key-value pairs where the key is the item ID and the value is its new, optimized integer price.
item_importance (object): A business value ranking of items. It contains key-value pairs where the key is the item ID and the value is a float representing its rank. Items with a bigger value are better for the store.
item_good (array): A list of item IDs that are considered optimal for the store and for profit growth.
item_bad (array): A list of item IDs for items that are not optimal. It is recommended to replace these items with new items.
If there is an issue with the API request, the response will be a JSON object containing a single error key, or an empty object in one specific case.
Here are examples of how to call the Honama API in various languages. Remember to replace placeholder credentials with your own.