# Worten Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/worten/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/worten-search |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Search Worten Portugal and Spain electronics by keyword and get price, availability, rating, and specs as structured JSON in real time.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/worten/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search iPhones in Portugal

```json
{
  "page": 1,
  "country": "pt",
  "results": [
    {
      "id": "WPT-8934710",
      "url": "https://www.worten.pt/smartphones-e-comunicacoes/smartphones/apple-iphone-15-128gb-preto-5G-WPT-8934710.html",
      "brand": "Apple",
      "price": 829,
      "title": "Apple iPhone 15 128GB Preto 5G",
      "rating": 4.7,
      "category": "Smartphones",
      "thumbnail": "https://static.worten.pt/produtos/WPT-8934710/WPT-8934710_a.jpg",
      "availability": "in_stock",
      "review_count": 312,
      "original_price": 949,
      "discount_percent": 12.6
    },
    {
      "id": "WPT-8934711",
      "url": "https://www.worten.pt/smartphones-e-comunicacoes/smartphones/apple-iphone-15-256gb-azul-5G-WPT-8934711.html",
      "brand": "Apple",
      "price": 979,
      "title": "Apple iPhone 15 256GB Azul 5G",
      "rating": 4.8,
      "category": "Smartphones",
      "thumbnail": "https://static.worten.pt/produtos/WPT-8934711/WPT-8934711_a.jpg",
      "availability": "in_stock",
      "review_count": 198,
      "original_price": null,
      "discount_percent": null
    }
  ],
  "total_results": 847,
  "results_per_page": 24
}
```

## Documentation

## Overview

Worten is the leading electronics retailer in Portugal and one of the largest in Spain, part of the Sonae group. Its catalogue spans ~10M products across smartphones, TVs, laptops, gaming, audio, and home appliances. The platform applies Cloudflare bot protection. Piloterr handles the bypass and returns paginated product results as structured JSON.

Each result includes the SKU, title, brand, price in EUR, discount, stock status, rating, and thumbnail.

## Quickstart

```
GET https://api.piloterr.com/v2/worten/search?query=iphone+15&country=pt
```

## Main use cases

- Track real-time Worten prices for electronics price comparison across Portugal and Spain
- Monitor stock availability and discount levels across thousands of SKUs for restocking alerts
- Build a product database for Iberian electronics by collecting titles, brands, prices, and ratings
- Feed a price intelligence dashboard to benchmark positioning against Worten listings
- Detect flash sales by comparing current price against original price across the catalogue