# Hepsiburada Product Scraper

> Hepsiburada Product Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured product data from Hepsiburada (Turkish e-commerce) including listings, reviews, and Q&A via keyword searches or direct URLs

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/hepsiburada?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hepsiburada-product-scraper-a6a0a01a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tjiYPNA9I4OGGhxEo_u9c

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hepsiburada-product-scraper-a6a0a01a -d '<json body>'
```

Example prompt: Search Hepsiburada for 'bluetooth kulaklık' sorted by lowest price, grab up to 50 products priced between 200 and 800 TL with at least a 4-star rating, and include full product descriptions and specs.

## When to prefer this

Choose this endpoint when you need structured product data specifically from Hepsiburada (Turkey's major e-commerce platform), including support for Turkish-language keyword searches, price/rating filtering, and optional enrichment with reviews, Q&A, and detailed specifications. Prefer this over generic web scrapers when you need Hepsiburada-specific fields like merchant ratings, category paths, and barcodes in a clean, structured format without building your own scraping infrastructure.

## Known failure modes

- Empty result set if search terms return no products (not charged)
- Failed run if Hepsiburada blocks or rate-limits the scraper (not charged)
- Truncated results if maxItems limit is reached before all pages are collected
- Missing enriched fields if product pages are unavailable or structured data is absent
- Invalid URL input causing no results if startUrls point to non-Hepsiburada pages

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of results and an array of product items, each with fields such as SKU, URL, brand, title, category, product ID, record type, and category path. With optional enrichment enabled, also includes descriptions, category paths, specifications, barcodes, merchant ratings, and full image lists. Reviews and Q&A are returned as separate linked rows when enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum product rows per search term or URL. Broad listings expose up to 50 pages."
  },
  "getQna": {
   "type": "boolean",
   "default": false,
   "description": "Write separate question and merchant answer rows from the first public product-page batch."
  },
  "maxQna": {
   "type": "integer",
   "default": 10,
   "maximum": 10,
   "minimum": 0,
   "description": "Maximum question rows per product when question collection is on. The public product page exposes up to 10."
  },
  "sortBy": {
   "enum": [
    "recommended",
    "lowestPrice",
    "highestPrice",
    "bestSellers",
    "mostReviewed",
    "topRated",
    "highestDiscount",
    "newest"
   ],
   "type": "string",
   "default": "recommended",
   "description": "Ordering for keyword searches. A direct URL keeps its own ordering."
  },
  "queries": {
   "type": "array",
   "description": "Search terms to collect separately. Provide search terms, start URLs, or both."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Maximum rows across all targets, including optional review and question rows. Zero means no overall limit."
  },
  "maxPrice": {
   "type": "number",
   "minimum": 0,
   "description": "Keep products at or below this displayed price. Filtering is applied to collected pages."
  },
  "minPrice": {
   "type": "number",
   "minimum": 0,
   "description": "Keep products at or above this displayed price. Filtering is applied to collected pages."
  },
  "minRating": {
   "type": "number",
   "maximum": 5,
   "minimum": 0,
   "description": "Keep products whose displayed average rating meets this threshold."
  },
  "startUrls": {
   "type": "array",
   "description": "Public hepsiburada.com search pages, category pages, or direct product pages."
  },
  "enrichData": {
   "type": "boolean",
   "default": false,
   "description": "Add descriptions, category paths, specifications, barcode, merchant rating, and full image lists from product pages."
  },
  "getReviews": {
   "type": "boolean",
   "default": false,
   "description": "Write separate review rows linked by product ID and SKU. Product pages are fetched automatically."
  },
  "maxReviews": {
   "type": "integer",
   "default": 10,
   "minimum": 0,
   "description": "Maximum review rows per product when review collection is on. Zero skips reviews."
  },
  "discount
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "sku": null,
    "url": null,
    "brand": null,
    "title": null,
    "category": null,
    "productId": null,
    "recordType": null,
    "categoryPath": null
   }
  ],
  "product": "hepsiburada"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hepsiburada-product-scraper-a6a0a01a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)