Skip to main content
POST
/
api
/
hepsiburada
/
products
/
search
/hepsiburada/products/search
curl --request POST \
  --url https://api.anysite.io/api/hepsiburada/products/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "sort": "NONE",
  "brand": "<string>",
  "merchant": "<string>",
  "price_min": 1,
  "price_max": 1,
  "fast_delivery": false,
  "discounted_only": false,
  "with_photo_reviews": false,
  "authorized_seller": false,
  "recently_reviewed": false,
  "advantageous_price": false,
  "product_type": "<string>"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@hepsiburada_search_product",
    "product_id": "<string>",
    "name": "<string>",
    "brand": "<string>",
    "price": 123,
    "list_price": 123,
    "discount_percentage": 123,
    "currency": "<string>",
    "image": "<string>",
    "rating": 123,
    "rating_count": 123,
    "color_variant_count": 123,
    "seller_name": "<string>",
    "seller_id": "<string>",
    "category": "<string>",
    "is_in_stock": true
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
keyword
string
required

Search keyword

Minimum string length: 1
Examples:

"iphone 15"

"laptop"

"kahve makinesi"

count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
sort
enum<string>
default:NONE

Result ordering

Available options:
NONE,
artanfiyat,
azalanfiyat,
coksatan,
yorumsayisi,
degerlendirmepuani,
indirimurunler,
enyeni
brand
string | null

Filter by brand slug (e.g. apple, samsung, xiaomi)

merchant
string | null

Filter by seller (merchant) name

color
enum<string> | null

Filter by product color

Available options:
Siyah,
Beyaz,
Mavi,
Lacivert,
Mor,
Kırmızı,
Yeşil,
Sarı,
Pembe,
Gri,
Gümüş,
Kahverengi,
Turuncu,
Bej,
Krem,
Altın,
CokRenk
rating_min
enum<string> | null

Minimum customer review rating

Available options:
4.5-max,
4-max,
3-max
price_min
number | null

Minimum price in TRY

Required range: x >= 0
price_max
number | null

Maximum price in TRY

Required range: x >= 0
fast_delivery
boolean
default:false

Only products with fast delivery

discounted_only
boolean
default:false

Only discounted products

with_photo_reviews
boolean
default:false

Only products that have customer photo reviews

authorized_seller
boolean
default:false

Only authorized / official sellers

recently_reviewed
boolean
default:false

Only products reviewed in the last days

advantageous_price
boolean
default:false

Only products with advantageous prices

product_type
string | null

Filter by product type (main category) code, e.g. 98

Response

Successful Response

id
string
required
url
string
required
@type
string
default:@hepsiburada_search_product
product_id
string | null
name
string | null
brand
string | null
price
number | null
list_price
number | null
discount_percentage
number | null
currency
string | null
image
string | null
rating
number | null
rating_count
integer | null
color_variant_count
integer | null
seller_name
string | null
seller_id
string | null
category
string | null
is_in_stock
boolean | null