POSTPublicyjcx-oil-price-query-v2

Gas Price Lookup

Usage Cost

10 coins/call

Try it online

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

Documentation

API Overview

This API is used to query retail prices for refined oil products (gasoline, diesel) in various provinces and cities across mainland China. Developers can retrieve the official guidance price or market reference price for a specific date by providing the date, suitable for business systems that need to integrate energy cost data.

Use Cases

Logistics Freight Calculation: Dynamically adjust transportation cost estimates based on real-time or historical oil prices.
Travel Service Applications: Provide car owners with fuel cost references and fuel budgets for route planning.
Data Analysis Platforms: Build energy price trend charts to assist industry research and decision-making.

Request and Response Details

Request Method: POST
Core Parameters:
date (optional): Query date, format yyyyMMdd (e.g., 20231001). If not provided, the latest available data will be returned by default.
Response Result: Contains a list of price information for various grades of oil products (e.g., 92#, 95# gasoline, 0# diesel, etc.) for the corresponding date.

Integration Recommendations

Caching Strategy: Oil price adjustments are infrequent (typically once every 10 working days). It is recommended to cache query results for the same date locally to reduce unnecessary API calls.
Error Handling: Please properly handle cases where data is returned for non-trading days or when data has not been updated, ensuring a user-friendly frontend display.
Date Format: It is crucial to strictly adhere to the yyyyMMdd format when passing the date parameter to avoid parsing errors.

Integration Examples

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

Request Example

{
  "date": "日期，格式：yyyyMMdd，比如：20220422，默认今日"
}

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.date	object	{...}
properties.date.type	string	string
properties.date.description	string	日期，格式：yyyyMMdd，比如：20220422，默认今日

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/yjcx-oil-price-query-v2' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "date": "日期，格式：yyyyMMdd，比如：20220422，默认今日"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2" payload = { "date": "日期，格式：yyyyMMdd，比如：20220422，默认今日" } 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/yjcx-oil-price-query-v2" payload := []byte("{\n \"date\": \"日期，格式：yyyyMMdd，比如：20220422，默认今日\"\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 \"date\": \"日期，格式：yyyyMMdd，比如：20220422，默认今日\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/yjcx-oil-price-query-v2")) .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/yjcx-oil-price-query-v2'; $payload = "{\n \"date\": \"日期，格式：yyyyMMdd，比如：20220422，默认今日\"\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;