POSTPublicagricultural-products-category

Regional Product Category 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 data retrieval capabilities based on specific regions and product categories. Developers can obtain corresponding market reference information by passing product names, region names, and an optional date, suitable for business systems that need to integrate agricultural market data from multiple locations.

Use Cases

Agricultural E-commerce Platforms: Recommend local specialty agricultural products or display real-time reference prices based on the user's location.
Market Monitoring Systems: Automatically collect specific agricultural product data from different regions and generate price trend reports.
Supply Chain Procurement: Assist procurement personnel in comparing agricultural product supply conditions across different production areas.

Request and Response Details

Request Method: POST
Core Parameters:
categoryName (Required): Product name, e.g., "Apple", "Rice".
region (Required): Region name, e.g., "Yantai, Shandong", "Heilongjiang".
date (Optional): Query date, format yyyy-MM-dd, defaults to today.
Response Result: Returns a data object containing agricultural product information matching the specified region and category. The specific field structure is subject to the actual response.

Integration Recommendations

Parameter Standardization: It is recommended to use standard administrative divisions or common origin aliases for region names to improve matching accuracy.
Caching Strategy: For display scenarios with less stringent real-time requirements, it is recommended to short-term cache query results for the same region and category to reduce API call frequency.
Error Handling: Please handle cases where no data is returned gracefully. The frontend should provide a user-friendly prompt instead of directly reporting an error.

Integration Examples

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

Request Example

{
  "categoryName": "商品名称",
  "region": "地区名称",
  "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.categoryName	object	{...}
properties.categoryName.type	string	string
properties.categoryName.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

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

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