Market Radar API (1.0.0)
Download OpenAPI specification:Download
This API provides programmatic access to Kemiex's market intelligence data. Whether you're building internal dashboards, integrating with procurement systems, or developing custom market analysis tools, this API provides the structured data you need to leverage Kemiex's market intelligence.
In addition to standard headers that you would expect, each response contains the following specific headers:
Header | Description |
---|---|
X-Trace-Id |
Trace identifier used to track each request against internal logs |
X-Server-Version |
Version of the server that responded |
When asking for support, please provide them as reference if possible.
Kemiex uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx
range indicate success. Codes in the 4xx
range indicate an error that failed given the information provided. Codes in the 5xx
range indicate an error with Kemiex’s servers.
Unsuccessful responses contain 2 parts: an error code, and user-friendly message describing the issue. You can expect the following errors, though more may be added in the future:
Error Code |
Description |
---|---|
BAD_REQUEST_RESOURCE_NOT_FOUND |
Client-side error: the URL address is wrong |
BAD_REQUEST_METHOD_NOT_SUPPORTED |
Client-side error: the HTTP method used in the request is not supported by the endpoint |
BAD_REQUEST_MISSING_REQUIRED_PARAMETER |
Client-side error: at least one of the required parameters is not provided |
BAD_REQUEST_PARAMETER_TYPE_MISMATCH |
Client-side error: a parameter value does not match its expected type |
BAD_REQUEST_PARAMETER_VALUE_ILLEGAL |
Client-side error: a parameter value is outside the range of values allowed |
BAD_REQUEST |
General client-side error: The request cannot be processed. This is a catch-all error thrown when the errors above do not apply |
FORBIDDEN |
The API key is not provided, or the provided value is incorrect, or the associated account does not have access to the requested resource |
INTERNAL_SERVER_ERROR |
An unexpected condition was encountered on the server |
A rate limit of 100 quota units per minute is enforced. Exceeding this limit returns HTTP code 429. The table below lists the corresponding quota units consumed per api endpoint.
Endpoint | Quota units |
---|---|
/price-benchmarks |
1 unit |
Retrieve Market News
Returns Market News that were published in the specified time interval and matching optional search criteria. The time interval boundaries are inclusive.
Authorizations:
query Parameters
publishFrom required | string <date-time> Examples:
The published start date in ISO 8601-1:2019 combined date and time standard |
publishTo | string <date-time> Examples:
The published end date in ISO 8601-1:2019 combined date and time standard. If it is not provided, it is automatically set to the current date time |
categories | Array of strings Items Enum: "Accident" "Agriculture" "Americas" "Amino acids" "Analysis" "APIs" "Asia" "Commentary" "Company news" "Europe" "Expansion" "Featured" "Feed additives" "Financial reports" "Food additives" "Kemiex report" "Legal and compliance" "Logistics" "Strategic transactions" "Vitamins" An additional filter for searching market news related only to specific categories. In case multiple values are provided, we consider an AND operation between them (market news that have all values from the given list as categories will be considered matched). |
textSearch | string Examples:
An additional filter for searching market news with title or summary complying the given full text search criteria. It can be constructed using the rules of websearch_to_tsquery postgresql function, in English language |
page | integer <int32> >= 1 Default: 1 Example: page=1 List results on a specific page. Starting page is 1 |
pageSize | integer <int32> [ 1 .. 100 ] Default: 50 Example: pageSize=50 Maximum number of results that should be returned per page. Please keep it constant for requests across multiple pages, in order to correctly receive all results. |
Responses
Response samples
- 200
- 400
- 403
- 500
{- "results": [
- {
- "uuid": "b43dd825-8a99-4676-aae7-9b91817c2c3c",
- "published": "2025-03-25T10:00:00Z",
- "title": "string",
- "summary": "string",
- "categories": [
- "Europe",
- "Asia",
- "Vitamins",
- "Feed additives",
- "Food additives"
],
}
], - "pageNumber": 3,
- "pageSize": 40,
- "totalResults": 193,
- "totalPages": 5
}
Retrieve price points
Returns weekly price points that include average, minimum, maximum, and own company submission values for the specified products and date range. Price Benchmark data is published every Wednesday.
Authorizations:
query Parameters
products required | Array of strings A comma-separated list of product-region codes to query. Available products:
Available regions:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
startDate required | string The start date for the price points series |
Responses
Response samples
- 200
- 400
- 403
- 500
{- "data": [
- {
- "productCode": "VB1",
- "productName": "Vitamin B1 (Mono)",
- "regionCode": "EU",
- "regionName": "FCA Europe",
- "week": "2024-01-04",
- "currency": "USD",
- "unit": "MT",
- "average": 15.75,
- "minimum": 14.5,
- "maximum": 16.25,
- "ownCompanySubmission": 15
}
]
}