POSTPublicdrug-search

Drug Category Search

Search basic drug records by category ID with pagination.

Usage Cost

5 coins/call

Try it online

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

Documentation

Choose a broad drug category and subcategory from the cached classification list, then retrieve drug names, manufacturers, approval numbers, and drug IDs.

Integration Examples

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

Request Example

{
  "classifyId": "599ad27f600b2149d689b5c4",
  "page": "1",
  "maxResult": "20"
}

Response Example

{
  "count": 1,
  "page": 1,
  "maxResult": 20,
  "data": [
    {
      "drugName": "示例药品",
      "manu": "示例药企",
      "pzwh": "国药准字Z00000000",
      "drugId": "59c9aa2f0b5b76e52ff0c440"
    }
  ]
}

Request Fields

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

Path	Type	Sample
classifyId	string	599ad27f600b2149d689b5c4
page	string	1
maxResult	string	20

Response Fields

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

Path	Type	Sample
count	number	1
page	number	1
maxResult	number	20
data	array	{"drugName":"示例药品","manu":"示例药企","pzwh":"国药准字Z00000000","drugId":"59c9aa2f0b5b76e52ff0c440"}
data[]	object	{...}
data[].drugName	string	示例药品
data[].manu	string	示例药企

curl --request POST \ --url 'https://openapi.toolkk.com/v1/drug-search' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "classifyId": "599ad27f600b2149d689b5c4",\n "page": "1",\n "maxResult": "20"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/drug-search" payload = { "classifyId": "599ad27f600b2149d689b5c4", "page": "1", "maxResult": "20" } 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/drug-search" payload := []byte("{\n \"classifyId\": \"599ad27f600b2149d689b5c4\",\n \"page\": \"1\",\n \"maxResult\": \"20\"\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 \"classifyId\": \"599ad27f600b2149d689b5c4\",\n \"page\": \"1\",\n \"maxResult\": \"20\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/drug-search")) .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/drug-search'; $payload = "{\n \"classifyId\": \"599ad27f600b2149d689b5c4\",\n \"page\": \"1\",\n \"maxResult\": \"20\"\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;

Drug Category Search

Try it online

Documentation

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example