Piloterr

Fnac Search

GET
/v2/fnac/search

Search Fnac for a keyword or a SearchResult URL. Each card has the product id, name, price, seller, and stock.

Credit cost: 2 credits per call

Authentification

ApiKeyAuth
headerx-api-key<token>

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

Paramètres de requête

query*string

Keyword or a Fnac SearchResult URL. A product URL returns 400.

Example:

iphone
page?number

Page number, from 1. Default is 1. Page 2 is sent as PageIndex=2.

return_page_source?boolean

When true, returns the raw HTML instead of the parsed JSON.

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

Corps de la réponse

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/fnac/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.fnac.com/Apple-iPhone-18-Pro-6-3-5G-Double-SIM-256-Go-Argent/a23428278/w-4",      "name": "Apple iPhone 18 Pro 6,3\" 5G Double SIM 256 Go Argent",      "brand": "Apple",      "image": "https://static.fnac-static.com/multimedia/Images/FR/MDM/a3/73/c7/29848483/1545-1/tsp20261005171514/Apple-iPhone-18-Pro-6-3-5G-Double-SIM-256-Go-Argent.jpg",      "price": 1479,      "rating": 5,      "seller": "FNAC.COM",      "category": "iPhone",      "currency": "EUR",      "in_stock": true,      "position": 1,      "condition": "neuf",      "product_id": "23428278",      "offers_from": 1352,      "review_count": 4,      "price_display": "1 479 €",      "offers_from_display": "1 352 €"    }  ],  "pagination": {    "next": "https://www.fnac.com/SearchResult/ResultList.aspx?PageIndex=2&Search=iphone&sft=1",    "page": 1,    "per_page": 20  }}