car-series-query
Find Car Series by Brand
Enter a car brand ID to instantly retrieve the corresponding car series information.
Usage Cost
10 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/car-series-querycURL Example
curl --request GET \
--url 'https://openapi.toolkk.com/v1/car-series-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/car-series-query"
payload = {}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.get(url, headers=headers, params=payload, timeout=30)
response.raise_for_status()
print(response.json())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/car-series-query"
payload := []byte("{}")
req, err := http.NewRequest("GET", 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))
}Java Example
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 = "{}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/car-series-query"))
.method("GET", 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 Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/car-series-query';
$payload = "{}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
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;Response Example
{}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
No field definitions yet. Refer to the JSON examples and documentation.
Request Example
{}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
No field definitions yet. Refer to the JSON examples and documentation.
Response Example
{}API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Introduction
This API provides a service to query car series lists based on car brand ID. Developers can pass a valid car brand identifier (ID) to retrieve all associated car series details under that brand, including car series names and basic attributes. The data structure is clear, facilitating frontend display or backend logic processing.
Use Cases
- Automotive Vertical Media: Build brand-series cascading selectors to optimize the user's car selection experience.
- Used Car Trading Platforms: Automatically load available car series based on the selected brand when listing a vehicle, reducing manual input errors.
- Car Insurance Quotation Systems: Quickly identify the specific car series for a vehicle, providing data support for accurate underwriting and quotations.
- Dealership Management Systems: Synchronize OEM brand architecture and maintain the accuracy of internal vehicle model databases.
Request and Response Details
- Request Method: GET
- Core Parameter: Requires
brand_id(Car Brand ID). Please ensure the ID is a valid numeric or string format recognized by the upstream data source.