Qidiruv API — Kitobchi Developer API

GET https://kitobchi.com/api/v1/client/search ⚡ Keshlanadi read

Global qidiruv

Nom, muallif, kategoriya va turga qarab natija qaytaradi.

Parametr	Turi	Joyi	Majburiy	Tavsifi
q	string	query	Ha	Qidiruv matni.
page	integer	query	Yo‘q	Sahifa raqami.

curl --request GET \
  --url 'https://kitobchi.com/api/v1/client/search?q=python&page=1' \
  --header 'Accept: application/json' \
  --header 'X-App-ID: app_xxxxxxxxxxxx' \
  --header 'X-App-Secret: your-secret'

const res = await fetch("https://kitobchi.com/api/v1/client/search?q=python&page=1", {
  headers: {
    "Accept": "application/json",
    "X-App-ID": "app_xxxxxxxxxxxx",
    "X-App-Secret": process.env.KITOBCHI_APP_SECRET,
  },
});
const data = await res.json();

<?php
$ch = curl_init("https://kitobchi.com/api/v1/client/search?q=python&page=1");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'X-App-ID: app_xxxxxxxxxxxx',
    'X-App-Secret: ' . getenv('KITOBCHI_APP_SECRET'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

res = requests.get(
    "https://kitobchi.com/api/v1/client/search?q=python&page=1",
    headers={
        "Accept": "application/json",
        "X-App-ID": "app_xxxxxxxxxxxx",
        "X-App-Secret": os.environ["KITOBCHI_APP_SECRET"],
    },
)
data = res.json()

Muvaffaqiyatli javob 200 OK

{
    "status": "success",
    "data": [
        {
            "id": 128,
            "name": "Python bilan dasturlash",
            "type": "book",
            "price": 120000,
            "image": "https://kitobchi.com/storage/books/128.jpg"
        }
    ],
    "meta": {
        "page": 1,
        "total": 37
    }
}

⚡ Live Konsolda Sinab Ko'rish (Try It Out)

X-App-ID X-App-Secret q * page

GET https://kitobchi.com/api/v1/client/search/suggestions ⚡ Keshlanadi read

Autocomplete takliflari

Qidiruv maydoni uchun tezkor takliflar (nom, muallif, teg).

Parametr	Turi	Joyi	Majburiy	Tavsifi
q	string	query	Ha	Qidiruv boshlanmasi.
seller_id	integer	query	Yo‘q	Bitta do‘kon ichida cheklash.

curl --request GET \
  --url 'https://kitobchi.com/api/v1/client/search/suggestions?q=pyth' \
  --header 'Accept: application/json' \
  --header 'X-App-ID: app_xxxxxxxxxxxx' \
  --header 'X-App-Secret: your-secret'

const res = await fetch("https://kitobchi.com/api/v1/client/search/suggestions?q=pyth", {
  headers: {
    "Accept": "application/json",
    "X-App-ID": "app_xxxxxxxxxxxx",
    "X-App-Secret": process.env.KITOBCHI_APP_SECRET,
  },
});
const data = await res.json();

<?php
$ch = curl_init("https://kitobchi.com/api/v1/client/search/suggestions?q=pyth");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'X-App-ID: app_xxxxxxxxxxxx',
    'X-App-Secret: ' . getenv('KITOBCHI_APP_SECRET'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

res = requests.get(
    "https://kitobchi.com/api/v1/client/search/suggestions?q=pyth",
    headers={
        "Accept": "application/json",
        "X-App-ID": "app_xxxxxxxxxxxx",
        "X-App-Secret": os.environ["KITOBCHI_APP_SECRET"],
    },
)
data = res.json()

Muvaffaqiyatli javob 200 OK

{
    "status": "success",
    "data": [
        "Python",
        "Python bilan dasturlash",
        "Pythonic"
    ]
}

⚡ Live Konsolda Sinab Ko'rish (Try It Out)

X-App-ID X-App-Secret q * seller_id

GET https://kitobchi.com/api/v1/client/search/trending ⚡ Keshlanadi read

Trend so‘rovlar

Oxirgi 7 kunda eng ko‘p qidirilgan so‘rovlar.

curl --request GET \
  --url 'https://kitobchi.com/api/v1/client/search/trending' \
  --header 'Accept: application/json' \
  --header 'X-App-ID: app_xxxxxxxxxxxx' \
  --header 'X-App-Secret: your-secret'

const res = await fetch("https://kitobchi.com/api/v1/client/search/trending", {
  headers: {
    "Accept": "application/json",
    "X-App-ID": "app_xxxxxxxxxxxx",
    "X-App-Secret": process.env.KITOBCHI_APP_SECRET,
  },
});
const data = await res.json();

<?php
$ch = curl_init("https://kitobchi.com/api/v1/client/search/trending");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'X-App-ID: app_xxxxxxxxxxxx',
    'X-App-Secret: ' . getenv('KITOBCHI_APP_SECRET'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

res = requests.get(
    "https://kitobchi.com/api/v1/client/search/trending",
    headers={
        "Accept": "application/json",
        "X-App-ID": "app_xxxxxxxxxxxx",
        "X-App-Secret": os.environ["KITOBCHI_APP_SECRET"],
    },
)
data = res.json()

Muvaffaqiyatli javob 200 OK

{
    "status": "success",
    "data": [
        {
            "text": "atomic habits",
            "result_name": "Atomic Habits",
            "total_count": 512
        }
    ]
}

⚡ Live Konsolda Sinab Ko'rish (Try It Out)

X-App-ID X-App-Secret

GET https://kitobchi.com/api/v1/client/search/categories ⚡ Keshlanadi read

Kategoriyalar

Katalog menyusi va filtr paneli uchun kategoriyalar ro‘yxati.

curl --request GET \
  --url 'https://kitobchi.com/api/v1/client/search/categories' \
  --header 'Accept: application/json' \
  --header 'X-App-ID: app_xxxxxxxxxxxx' \
  --header 'X-App-Secret: your-secret'

const res = await fetch("https://kitobchi.com/api/v1/client/search/categories", {
  headers: {
    "Accept": "application/json",
    "X-App-ID": "app_xxxxxxxxxxxx",
    "X-App-Secret": process.env.KITOBCHI_APP_SECRET,
  },
});
const data = await res.json();

<?php
$ch = curl_init("https://kitobchi.com/api/v1/client/search/categories");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'X-App-ID: app_xxxxxxxxxxxx',
    'X-App-Secret: ' . getenv('KITOBCHI_APP_SECRET'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

res = requests.get(
    "https://kitobchi.com/api/v1/client/search/categories",
    headers={
        "Accept": "application/json",
        "X-App-ID": "app_xxxxxxxxxxxx",
        "X-App-Secret": os.environ["KITOBCHI_APP_SECRET"],
    },
)
data = res.json()

Muvaffaqiyatli javob 200 OK

{
    "status": "success",
    "data": [
        {
            "id": 3,
            "name": "Biznes",
            "type": "book",
            "children": []
        }
    ]
}

⚡ Live Konsolda Sinab Ko'rish (Try It Out)

X-App-ID X-App-Secret

GET https://kitobchi.com/api/v1/client/search/category/{cat_id}/{type} ⚡ Keshlanadi read

Kategoriya mahsulotlari

Bitta kategoriya ichidagi mahsulotlarni turi bo‘yicha qaytaradi.

Parametr	Turi	Joyi	Majburiy	Tavsifi
cat_id	integer	path	Ha	Kategoriya ID.
type	string	path	Ha	Mahsulot turi: book yoki stationery.
page	integer	query	Yo‘q	Sahifa raqami.

curl --request GET \
  --url 'https://kitobchi.com/api/v1/client/search/category/3/book?page=1' \
  --header 'Accept: application/json' \
  --header 'X-App-ID: app_xxxxxxxxxxxx' \
  --header 'X-App-Secret: your-secret'

const res = await fetch("https://kitobchi.com/api/v1/client/search/category/3/book?page=1", {
  headers: {
    "Accept": "application/json",
    "X-App-ID": "app_xxxxxxxxxxxx",
    "X-App-Secret": process.env.KITOBCHI_APP_SECRET,
  },
});
const data = await res.json();

<?php
$ch = curl_init("https://kitobchi.com/api/v1/client/search/category/3/book?page=1");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'X-App-ID: app_xxxxxxxxxxxx',
    'X-App-Secret: ' . getenv('KITOBCHI_APP_SECRET'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import os, requests

res = requests.get(
    "https://kitobchi.com/api/v1/client/search/category/3/book?page=1",
    headers={
        "Accept": "application/json",
        "X-App-ID": "app_xxxxxxxxxxxx",
        "X-App-Secret": os.environ["KITOBCHI_APP_SECRET"],
    },
)
data = res.json()

Muvaffaqiyatli javob 200 OK

{
    "status": "success",
    "data": [],
    "meta": {
        "page": 1,
        "total": 96
    }
}

⚡ Live Konsolda Sinab Ko'rish (Try It Out)

X-App-ID X-App-Secret cat_id type page