> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hepsiburada Category Products

> List products in a Hepsiburada category with filters (brand, seller, color, price range, minimum rating, fast delivery, discounted, photo reviews, authorized sellers) and sorting. Returns id, name, brand, price, list price, discount, image, rating and seller. 1 point per returned record.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-hepsiburada-categories-products
openapi: 3.0.0
info:
  title: NeuralVerge API
  version: 1.0.0
  description: >-
    NeuralVerge API for AI research workflows, search, extraction, and
    structured data source execution.
servers:
  - url: https://api.neuralverge.ai
    description: NeuralVerge API
security:
  - BearerAuth: []
tags:
  - name: AI Research
    description: Research workflows and session tracking.
  - name: AI Extract
    description: Schema-driven extraction workflows.
  - name: AI Agents
    description: Reusable saved agents executed through the API.
  - name: Search
    description: Fast, synchronous web search with no session or polling.
  - name: Company intelligence
    description: Company profile lookups from company databases.
  - name: E-commerce & Marketplaces
    description: >-
      Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress,
      and Alibaba.
  - name: Enrichment
    description: Email and phone enrichment, validation, and discovery.
  - name: Product reviews
    description: >-
      Software and business reviews from Capterra, Gartner Peer Insights, and
      Trustpilot.
  - name: Social media
    description: LinkedIn profile, company, and people lookups.
paths:
  /functions/v1/run-hepsiburada-categories-products:
    post:
      tags:
        - E-commerce & Marketplaces
      summary: Hepsiburada Category Products
      description: >-
        List products in a Hepsiburada category with filters (brand, seller,
        color, price range, minimum rating, fast delivery, discounted, photo
        reviews, authorized sellers) and sorting. Returns id, name, brand,
        price, list price, discount, image, rating and seller. 1 point per
        returned record.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  description: Category ID or URL. e.g. 371965
                  type: string
                max_items:
                  description: Max items (up to 500)
                  type: integer
                  minimum: 1
                  maximum: 500
                  default: 25
                start_page:
                  description: Starting page
                  type: integer
                  minimum: 1
                price_min:
                  description: Min price (TRY)
                  type: number
                  minimum: 0
                price_max:
                  description: Max price (TRY)
                  type: number
                  minimum: 0
                sort:
                  description: >-
                    Sort by. Options: artanfiyat = Price: low to high,
                    azalanfiyat = Price: high to low, coksatan = Best sellers,
                    yorumsayisi = Most reviewed, degerlendirmepuani = Top rated,
                    indirimurunler = Biggest discount, enyeni = Newest
                  type: string
                  enum:
                    - artanfiyat
                    - azalanfiyat
                    - coksatan
                    - yorumsayisi
                    - degerlendirmepuani
                    - indirimurunler
                    - enyeni
                rating_min:
                  description: >-
                    Minimum rating. Options: 4.5-max = 4.5 and up, 4-max = 4 and
                    up, 3-max = 3 and up
                  type: string
                  enum:
                    - 4.5-max
                    - 4-max
                    - 3-max
                brand:
                  description: Brand (slug). e.g. e.g. apple, samsung
                  type: string
                color:
                  description: >-
                    Color. Options: Siyah = Siyah, Beyaz = Beyaz, Mavi = Mavi,
                    Lacivert = Lacivert, Mor = Mor, Kırmızı = Kırmızı, Yeşil =
                    Yeşil, Sarı = Sarı, Pembe = Pembe, Gri = Gri, Gümüş = Gümüş,
                    Kahverengi = Kahverengi, Turuncu = Turuncu, Bej = Bej, Krem
                    = Krem, Altın = Altın, CokRenk = CokRenk
                  type: string
                  enum:
                    - Siyah
                    - Beyaz
                    - Mavi
                    - Lacivert
                    - Mor
                    - Kırmızı
                    - Yeşil
                    - Sarı
                    - Pembe
                    - Gri
                    - Gümüş
                    - Kahverengi
                    - Turuncu
                    - Bej
                    - Krem
                    - Altın
                    - CokRenk
                merchant:
                  description: Seller name (exact, case sensitive). e.g. e.g. Hepsiburada
                  type: string
                product_type:
                  description: Main category code. e.g. e.g. 98 (laptops)
                  type: string
                fast_delivery:
                  description: Fast delivery
                  type: boolean
                discounted_only:
                  description: Discounted only
                  type: boolean
                with_photo_reviews:
                  description: With photo reviews
                  type: boolean
                authorized_seller:
                  description: Authorized sellers
                  type: boolean
                recently_reviewed:
                  description: Recently reviewed (last 10 days)
                  type: boolean
                advantageous_price:
                  description: Advantageous price
                  type: boolean
              required:
                - category
            example:
              category: '371965'
              max_items: 2
      responses:
        '200':
          description: Run completed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    description: Session identifier for this run.
                  kind:
                    type: string
                    description: Data source identifier for this endpoint.
                  category:
                    type: string
                  max_items:
                    type: integer
                  start_page:
                    type: integer
                  sort:
                    type: string
                  brand: {}
                  merchant: {}
                  color: {}
                  rating_min: {}
                  price_min: {}
                  price_max: {}
                  fast_delivery:
                    type: boolean
                  discounted_only:
                    type: boolean
                  with_photo_reviews:
                    type: boolean
                  authorized_seller:
                    type: boolean
                  recently_reviewed:
                    type: boolean
                  advantageous_price:
                    type: boolean
                  product_type: {}
                  partial:
                    type: boolean
                    description: >-
                      True when the scrape stopped early and returned the
                      records collected so far.
                  human:
                    type: string
                    description: Markdown summary of the result, for display.
                  machine:
                    type: object
                    properties:
                      total_items:
                        type: integer
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            '@type':
                              type: string
                            id:
                              type: string
                            product_id:
                              type: string
                            url:
                              type: string
                            name:
                              type: string
                            brand:
                              type: string
                            price:
                              type: integer
                            list_price:
                              type: integer
                            discount_percentage:
                              type: integer
                            currency:
                              type: string
                            image:
                              type: string
                            rating:
                              type: number
                            rating_count:
                              type: integer
                            color_variant_count:
                              type: integer
                            seller_name:
                              type: string
                            seller_id:
                              type: string
                            category:
                              type: string
                            is_in_stock:
                              type: boolean
                      response_bytes:
                        type: integer
                    description: Structured result payload.
                  total_points:
                    type: integer
                    description: Points charged for this run.
              example:
                session_id: 11111111-1111-1111-1111-111111111111
                kind: hepsiburada_categories_products
                category: '371965'
                max_items: 2
                start_page: 1
                sort: NONE
                brand: null
                merchant: null
                color: null
                rating_min: null
                price_min: null
                price_max: null
                fast_delivery: false
                discounted_only: false
                with_photo_reviews: false
                authorized_seller: false
                recently_reviewed: false
                advantageous_price: false
                product_type: null
                partial: false
                human: |-
                  # Hepsiburada category products

                  - **Category:** 371965
                  - **Starting page:** 1
                  - **Max items:** 2
                  - **Records returned:** 2
                  - **Proxy traffic:** 2.54 MB
                machine:
                  total_items: 2
                  items:
                    - '@type': HepsiburadaSearchProduct
                      id: HBCV00004X9ZCK
                      product_id: HBC00004X9ZCG
                      url: >-
                        https://www.hepsiburada.com/apple-iphone-15-128-gb-mavi-p-HBCV00004X9ZCK
                      name: Apple iPhone 15 128 GB Mavi
                      brand: Apple
                      price: 57049
                      list_price: 57049
                      discount_percentage: 0
                      currency: TRY
                      image: >-
                        https://productimages.hepsiburada.net/s/462/500/110000498600869.jpg
                      rating: 4.8
                      rating_count: 13022
                      color_variant_count: 3
                      seller_name: Hepsiburada
                      seller_id: e750130c-d0ff-469f-8767-66a63af8ea0c
                      category: iPhone iOS Telefonlar
                      is_in_stock: true
                    - '@type': HepsiburadaSearchProduct
                      id: HBCV00004X9ZCH
                      product_id: HBC00004X9ZCG
                      url: >-
                        https://www.hepsiburada.com/apple-iphone-15-128-gb-siyah-p-HBCV00004X9ZCH
                      name: Apple iPhone 15 128 GB Siyah
                      brand: Apple
                      price: 56999
                      list_price: 56999
                      discount_percentage: 0
                      currency: TRY
                      image: >-
                        https://productimages.hepsiburada.net/s/462/500/110000498569710.jpg
                      rating: 4.8
                      rating_count: 13022
                      color_variant_count: 3
                      seller_name: Hepsiburada
                      seller_id: e750130c-d0ff-469f-8767-66a63af8ea0c
                      category: iPhone iOS Telefonlar
                      is_in_stock: true
                  response_bytes: 2661314
                total_points: 2
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '402':
          description: Payment Required
        '500':
          description: Internal Error
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````