Piloterr

Action Search

GET
/v2/action/search

Action Search API: search product listings by keyword or URL on Action.com across European locales. Returns prices, images, locale, currency and pagination via browser rendering.

Credit cost: 2 credits per call

Autorización

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parámetros de consulta

query*string

Search keyword or full Action.com search URL.

Examples:

meuble
https://www.action.com/fr-fr/search/?q=meuble
https://www.action.com/pt-pt/search/?q=cabide

Use Action Product on any result url or product_id for full PDP data.

region?string

Locale (fr-fr, de-de, pt-pt, …) or country code (fr, de, pt). Default: fr-fr.

For multilingual countries use full locale (fr-be, nl-be, fr-ch, de-ch, it-ch).

page?number

1-based page number (default: 1).

Range1 <= value <= 500
return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Cuerpo de la respuesta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/action/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.action.com/fr-fr/p/3220594/meuble-d-entree/",      "price": 32.95,      "title": "Meuble d'entrée",      "locale": "fr-fr",      "currency": "EUR",      "image_url": "https://asset.action.com/image/upload/3220594_8718964261123-110_01_l7lvqj",      "product_id": "3220594"    },    {      "url": "https://www.action.com/fr-fr/p/3216159/etagere/",      "price": 39.95,      "title": "Étagère",      "locale": "fr-fr",      "currency": "EUR",      "image_url": "https://asset.action.com/image/upload/3216159_8718964237609-110_01_lbhy6y",      "product_id": "3216159"    },    {      "url": "https://www.action.com/fr-fr/p/3220583/etagere/",      "price": 29.95,      "title": "Étagère",      "locale": "fr-fr",      "currency": "EUR",      "image_url": "https://asset.action.com/image/upload/3220583_8718964261420-110_01_uoqzby",      "product_id": "3220583"    }  ],  "pagination": {    "next": "https://www.action.com/fr-fr/search/?q=meuble&page=2#product-grid",    "page": 1,    "per_page": 24,    "total_pages": 8,    "total_results": 185  }}