Skip to main content
Piloterr
Back to library

Action Search API

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.

Active2 credits = 1 requestGET/v2/action/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Action Search API returns product listings from Action. Pass a keyword or a full search URL, optionally with region, and receive structured JSON with prices, images, locale, currency, and pagination.

Piloterr uses browser rendering and parses Action.com Next.js RSC payloads (self.__next_f.push(...)) with DOM / JSON-LD fallbacks.

Use each result url or product_id with Action Product for full PDP data (specs, images, availability).

Supported regionsLink to 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

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

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/action/search?query=meuble
GET https://api.piloterr.com/v2/action/search?query=meuble&region=fr-fr
GET https://api.piloterr.com/v2/action/search?query=https://www.action.com/fr-fr/search/?q=meuble&page=2
GET https://api.piloterr.com/v2/action/search?query=cabide&region=pt-pt

ParametersLink to Parameters

Parameter Type Required Description
query string yes Keyword or full Action search URL
region string no Locale or country code (default: fr-fr)
page integer no 1-based page number (default: 1)
return_page_source boolean no Raw HTML as {"result": "..."} (default: false)

Input formatsLink to Input formats

Format Example
Keyword meuble with region=fr-fr
Full URL https://www.action.com/fr-fr/search/?q=meuble
Paginated URL https://www.action.com/fr-fr/search/?q=meuble&page=2

Response — each listing (results[])Link to Response — each listing (results[])

Field Type Description
product_id string Action article code
title string Product name
url string Absolute product URL
image_url string Main image
price number Current price (incl. tax)
currency string ISO currency code
locale string Locale used

Response — paginationLink to Response — pagination

Field Type Description
page integer Current page
per_page integer Results on this page
total_results integer | null Total matches
total_pages integer | null Total pages
next string | null Next page URL

Action workflowLink to Action workflow

  1. Action Search — discover listings (this endpoint)
  2. Action Product — full PDP JSON

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query / region
404 Page without parseable results
500 Rendering or parsing error

NotesLink to Notes

  • Single-page searches may return total_pages: 1 and next: null.
  • Costs 2 credits per call (browser rendering).

Main use casesLink to Main use cases

  • Price monitoring — track Action listings across European locales
  • Catalog discovery — harvest product_id and URLs at scale
  • Cross-border retail intel — compare availability and pricing by region

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included