POSTPublicagricultural-products-price-list

Regional Product Search

Usage Cost

30 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Introduction

This API allows querying agricultural product market price data for a specific date using product and region names. The results include the lowest, highest, and average prices, along with the unit of measurement for the specified product in the given region, providing developers with structured agricultural market insights.

Use Cases

Agricultural E-commerce Platforms: Display real-time or historical reference prices to assist user decision-making.
Data Analysis Applications: Build agricultural product price trend charts and analyze regional price differences.
Supply Chain Management Systems: Monitor fluctuations in procurement costs and optimize inventory and pricing strategies.

Request and Response Details

Request Method: POST
Core Parameters:
productName (Required): Product name, e.g., "Beihai No. 1 Hami Melon".
region (Required): Region name, e.g., "Weifang, Shandong".
date (Optional): Query date, format yyyy-MM-dd, defaults to today.
Response Data:
data.items: An array of price lists, including fields such as lowPrice (lowest price), avgPrice (average price), highPrice (highest price), and unit (unit of measurement).
code: Status code, 200 indicates success.

Integration Recommendations

Parameter Standardization: Ensure that the passed region name and product standard name accurately match to improve query hit rates.
Caching Strategy: As agricultural product prices have limited daily update frequency, it is recommended to cache query results for the same region and date to reduce redundant calls.
Error Handling: Handle cases where no data is returned (empty items) and provide a user-friendly prompt on the frontend.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "productName": "商品名称",
  "region": "地区名称",
  "date": "日期，格式：yyyy-MM-dd，默认当天"
}

Response Example

{
  "code": 200,
  "msg": "成功",
  "taskNo": "192365493231988621883813",
  "data": {
    "count": 2,
    "items": [
      {
        "productName": "北海一号哈密瓜",
        "unit": "元/斤",
        "region": "山东潍坊",
        "date": "2026-05-06",
        "lowPrice": 0.9,
        "avgPrice": 0.9,
        "highPrice": 0.9
      },
      {
        "productName": "北海一号哈密瓜",
        "unit": "元/斤",
        "region": "山东潍坊",
        "date": "2026-05-06",
        "lowPrice": 0.9,
        "avgPrice": 0.9,
        "highPrice": 0.9
      }
    ]
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
type	string	object
properties	object	{...}
properties.productName	object	{...}
properties.productName.type	string	string
properties.productName.description	string	商品名称
properties.region	object	{...}
properties.region.type	string

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
type	string	object
properties	object	{...}
properties.code	object	{...}
properties.code.type	string	number
properties.code.example	number	200
properties.code.description	string	返回码，详见返回码说明
properties.msg	object

curl --request POST \ --url 'https://openapi.toolkk.com/v1/agricultural-products-price-list' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "productName": "商品名称",\n "region": "地区名称",\n "date": "日期，格式：yyyy-MM-dd，默认当天"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/agricultural-products-price-list" payload = { "productName": "商品名称", "region": "地区名称", "date": "日期，格式：yyyy-MM-dd，默认当天" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/agricultural-products-price-list" payload := []byte("{\n \"productName\": \"商品名称\",\n \"region\": \"地区名称\",\n \"date\": \"日期，格式：yyyy-MM-dd，默认当天\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"productName\": \"商品名称\",\n \"region\": \"地区名称\",\n \"date\": \"日期，格式：yyyy-MM-dd，默认当天\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/agricultural-products-price-list")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/agricultural-products-price-list'; $payload = "{\n \"productName\": \"商品名称\",\n \"region\": \"地区名称\",\n \"date\": \"日期，格式：yyyy-MM-dd，默认当天\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;