POSTPublicagricultural-products-market-price-list

Wholesale Market 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 provides agricultural product price data query services for major domestic wholesale markets. Developers can obtain price trend information for specific dates by specifying product names and wholesale market names, aiding agricultural big data analysis and supply chain decisions.

Use Cases

Fresh E-commerce Pricing: Optimize retail pricing strategies by referencing wholesale market source prices.
Agricultural Data Analysis: Build agricultural product price trend models and monitor market fluctuations.
Supply Chain Management: Provide cost estimation basis for catering procurement and logistics distribution.

Request and Response Description

Request Method: POST
Core Parameters:
productName (required): Product name, such as "cabbage", "apple".
marketName (required): Wholesale market name, needs to accurately match the full or common name of the market.
date (optional): Query date, format yyyy-MM-dd, defaults to today.
Return Results: Contains a list of price details for the corresponding market and product on the specified date.

Integration Suggestions

Parameter Accuracy: It is recommended to use the standard full name for market names to improve matching success rate.
Caching Strategy: Historical price data changes less frequently; it is recommended to cache non-current day data locally to reduce the number of calls.
Error Handling: Please handle cases where no data is returned gracefully, which may occur if the market did not report or trade that category on the specified day.

Integration Examples

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

Request Example

{
  "productName": "商品名称",
  "marketName": "批发市场名称",
  "date": "日期，格式：yyyy-MM-dd，默认当天"
}

Response Example

{}

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.marketName	object	{...}
properties.marketName.type	string

Response Fields

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

Path	Type	Sample
type	string	object

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

import os import requests url = "https://openapi.toolkk.com/v1/agricultural-products-market-price-list" payload = { "productName": "商品名称", "marketName": "批发市场名称", "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-market-price-list" payload := []byte("{\n \"productName\": \"商品名称\",\n \"marketName\": \"批发市场名称\",\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 \"marketName\": \"批发市场名称\",\n \"date\": \"日期，格式：yyyy-MM-dd，默认当天\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/agricultural-products-market-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-market-price-list'; $payload = "{\n \"productName\": \"商品名称\",\n \"marketName\": \"批发市场名称\",\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;