# Action Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/action/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/action-product |

## Description

Action Product API: fetch full product page data from a product ID or URL on Action.com. Returns pricing, specs, images, breadcrumbs and availability via browser rendering.

## 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/action/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Étagère (3216159) on action.com fr-fr

```json
{
  "url": "https://www.action.com/fr-fr/p/3216159/etagere/",
  "price": 39.95,
  "title": "Étagère",
  "images": [
    "https://asset.action.com/image/upload/3216159_8718964237609-110_01_lbhy6y",
    "https://asset.action.com/image/upload/3216159_8718964237593-110_01_eglur0",
    "https://asset.action.com/image/upload/3216159_8718964237609-111_01_sofmt6"
  ],
  "locale": "fr-fr",
  "currency": "EUR",
  "in_stock": true,
  "image_url": "https://asset.action.com/image/upload/3216159_8718964237609-110_01_lbhy6y",
  "product_id": "3216159",
  "breadcrumbs": [
    "Habitat",
    "Meubles",
    "Étagère"
  ],
  "description": "Donnez un coup de jeune à votre salon avec cette étagère moderne. Les rayons ouverts sont parfaits pour vos plus belles décorations et plantes, tandis que le compartiment inférieur avec portes vous permet de ranger le tout de manière ordonnée.",
  "availability": "in_stock",
  "specifications": [
    {
      "key": "Couleur",
      "value": "Beige, Brun, Noir, Blanc"
    },
    {
      "key": "Matériau",
      "value": "Iron, Bois mdf, Melamine"
    },
    {
      "key": "Numéro de l'article",
      "value": "3216159"
    }
  ]
}
```

## Documentation

## Overview
The **Action Product API** returns full product page data from Action. Pass a **product ID** or **full product URL**, optionally with **`region`**, and receive structured JSON with pricing, images, specs, breadcrumbs, and availability.

Piloterr uses **browser rendering** and parses Next.js RSC product payloads with JSON-LD / DOM fallbacks.

Use [Action Search](https://www.piloterr.com/library/action-search) to discover listings, then [Action Product](https://www.piloterr.com/library/action-product) for the full record.

## Supported regions
`cs-cz`, `de-at`, `de-de`, `de-ch`, `es-es`, `fr-be`, `fr-fr`, `fr-lu`, `fr-ch`, `it-it`, `it-ch`, `nl-be`, `nl-nl`, `pl-pl`, `pt-pt`, `sk-sk`, `ro-ro`, `hr-hr`, `sl-si`

## Quickstart
```
GET https://api.piloterr.com/v2/action/product?query=3216159
GET https://api.piloterr.com/v2/action/product?query=3216159&region=fr-fr
GET https://api.piloterr.com/v2/action/product?query=https://www.action.com/fr-fr/p/3216159/etagere/
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product ID or full PDP URL |
| `region` | string | no | Locale or country code (default: `fr-fr`) |
| `return_page_source` | boolean | no | Raw HTML as `{"result": "..."}` (default: `false`) |

## Input formats
| Format | Example |
|---|---|
| Product ID | `3216159` |
| Full URL | `https://www.action.com/fr-fr/p/3216159/etagere/` |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_id` | string | Action article code |
| `title` | string | Product name |
| `url` | string | Canonical product URL |
| `description` | string \| null | Long or short description |
| `price` | number | Current price (incl. tax) |
| `currency` | string | ISO currency code |
| `image_url` | string | Main image |
| `images` | string[] \| null | Full gallery |
| `in_stock` | boolean | Availability flag |
| `availability` | string | `in_stock`, `out_of_stock`, … |
| `breadcrumbs` | string[] \| null | Category trail |
| `specifications` | object[] \| null | Attribute rows (`key`, `value`) |
| `locale` | string | Locale from URL or `region` |

## Action workflow
1. [Action Search](https://www.piloterr.com/library/action-search): discover listings
2. [Action Product](https://www.piloterr.com/library/action-product): full PDP JSON (this endpoint)

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing or invalid `query` / `region` |
| `404` | Unparsable or missing product page |
| `500` | Rendering or parsing error |

## Notes
- Costs **2 credits** per call (browser rendering).

## Main use cases
- **PDP enrichment**: specs, gallery, breadcrumbs
- **Inventory signals**: `availability` and price deltas
- **Multi-locale catalogs**: same SKU across Action regional sites