Search (sub)Categories by Text

EndpointId: API-GCA-007

Searches the category group tree by a free-text description and returns matching categories with their hierarchy, including `categoryId`, `categoryName`, `level`, and nested `children` nodes (subcategories and, where applicable, leaf `productId` entries).

Method: get

Parameters Specification

Parameter Field	Type	Constraints	Description / Default Value	Param Location
`typeId`	int	Required	Example Value: `1`	`path`
`langId`	int	Required	Example Value: `4`	`path`
`searchText`	string	Required	Example Value: `VALVE`	`path`

Use this endpoint

GET

https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE

curl -X GET 'https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE' \
  -H 'Accept: application/json' \
  -H 'x-apiprofile-key: YOUR_API_KEY'

const response = await fetch('https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'x-apiprofile-key': 'YOUR_API_KEY',
  },
});

const data = await response.json();
console.log(data);

const axios = require('axios');

const { data } = await axios({
  method: 'get',
  url: 'https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE',
  headers: {
    'Accept': 'application/json',
    'x-apiprofile-key': 'YOUR_API_KEY',
  },
});

console.log(data);

import requests

url = "https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE"

headers = {
    'Accept': 'application/json',
    'x-apiprofile-key': 'YOUR_API_KEY',
}

response = requests.request('GET', url, headers=headers)
print(response.json())

<?php

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'x-apiprofile-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Set("Accept", "application/json")
	req.Header.Set("x-apiprofile-key", "YOUR_API_KEY")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

require 'uri'
require 'net/http'
require 'json'

url = URI('https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = (url.scheme == 'https')

request = Net::HTTP::Get.new(url)
request['Accept'] = 'application/json'
request['x-apiprofile-key'] = 'YOUR_API_KEY'

response = http.request(request)
puts response.read_body

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE"))
    .header("Accept", "application/json")
    .header("x-apiprofile-key", "YOUR_API_KEY")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("GET"), "https://auto-parts-catalog.apiprofile.com/api/category/search-for-the-commodity-group-tree-by-description/type-id/1/lang-id/4/search-text/VALVE");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("x-apiprofile-key", "YOUR_API_KEY");

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);