Piloterr

Micromania Search

GET
/v2/micromania/search

Search Micromania for a keyword or a Search-Show URL. Each card has the product id, name, brand, EAN, price, and stock.

Credit cost: 2 credits per call

Autorisierung

ApiKeyAuth
headerx-api-key<token>

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

Abfrageparameter

query*string

Keyword or a Micromania Search-Show URL. A product URL returns 400.

Example:

zelda
page?number

Page number, from 1. Default is 1. Page 2 is sent as page=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

Antworttext

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/micromania/search?query=string'
Example Response
{  "results": [    {      "ean": "0045496337292",      "url": "https://www.micromania.fr/p/console-nintendo-switch-2-edition-limitee-40eme-anniversaire-the-legend-of-zelda-164787.html",      "name": "Console Nintendo Switch 2 Edition Limitée - 40ème Anniversaire The Legend Of Zelda",      "badge": "Nouveauté",      "brand": "NINTENDO",      "image": "https://www.micromania.fr/dw/image/v2/BCRB_PRD/on/demandware.static/-/Sites-masterCatalog_Micromania/default/dw6d0925d3/images/high-res/164787.jpg",      "price": 509.99,      "currency": "EUR",      "in_stock": false,      "position": 1,      "condition": "neuf",      "product_id": "164787",      "price_display": "509,99 €"    }  ],  "pagination": {    "next": "https://www.micromania.fr/on/demandware.store/Sites-Micromania-Site/fr_FR/Search-Show?q=zelda&page=2",    "page": 1,    "per_page": 20,    "total_pages": 4,    "total_results": 69  }}