company_search-query
Business Registration Fuzzy Search
Provides a fuzzy search feature for business registration information, helping users quickly retrieve key details like company names and registration numbers to boost data retrieval efficiency.
Usage Cost
15 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/company_search-querycURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/company_search-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "keyword": "阿里巴巴",\n "pageNum": 1,\n "pageSize": 10\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/company_search-query"
payload = {
"keyword": "阿里巴巴",
"pageNum": 1,
"pageSize": 10
}
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())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/company_search-query"
payload := []byte("{\n \"keyword\": \"阿里巴巴\",\n \"pageNum\": 1,\n \"pageSize\": 10\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))
}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 = "{\n \"keyword\": \"阿里巴巴\",\n \"pageNum\": 1,\n \"pageSize\": 10\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/company_search-query"))
.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 Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/company_search-query';
$payload = "{\n \"keyword\": \"阿里巴巴\",\n \"pageNum\": 1,\n \"pageSize\": 10\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;Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"total": 1,
"list": [
{
"name": "阿里巴巴(中国)有限公司",
"creditCode": "91330100799655058B",
"legalPerson": "张勇"
}
]
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 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.
Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| keyword | string | Unspecified | Unspecified | 阿里巴巴 |
| pageNum | number | Unspecified | Unspecified | 1 |
| pageSize | number | Unspecified | Unspecified | 10 |
Request Example
{
"keyword": "阿里巴巴",
"pageNum": 1,
"pageSize": 10
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| code | string | Unspecified | Unspecified | SUCCESS |
| message | string | Unspecified | Unspecified | success |
| data | object | Unspecified | Unspecified | {...} |
| data.total | number | Unspecified | Unspecified | 1 |
| data.list | array | Unspecified | Unspecified | [{"name":"阿里巴巴(中国)有限公司","creditCode":"91330100799655058B","legalPerson":"张勇"}] |
| data.list[] | object | Unspecified | Unspecified | {...} |
Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"total": 1,
"list": [
{
"name": "阿里巴巴(中国)有限公司",
"creditCode": "91330100799655058B",
"legalPerson": "张勇"
}
]
}
}$.code == 200 Documentation
Capabilities, use cases, and considerations.
Feature Introduction
This API provides powerful fuzzy search capabilities for business registration information. Users can input incomplete keywords such as company names, unified social credit codes, or registration numbers, and the system will intelligently match and return a list of qualifying companies. The search results include core business data such as company name, legal representative, registered capital, date of establishment, and operating status. The API supports high-concurrency requests, ensuring real-time and accurate queries.
Application Scenarios
- Corporate Background Checks: Financial institutions or partners can quickly obtain the registration information of target companies during risk assessments.
- Market Analysis & Competitive Intelligence: Market researchers can use fuzzy search to gain insights into the distribution of companies and the competitive landscape within an industry.
- Customer Information Verification: Sales or operations teams can quickly verify a customer's corporate identity before communicating with them.
- Government Services & Regulation: Government departments can efficiently retrieve relevant company records when conducting corporate data statistics and regulatory reviews.