Piloterr

Cultura Search

GET
/v2/cultura/search

Search Cultura by keyword and page through books, games, and culture products. Cards include title, price, availability, and the product link.

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

Words to search for on Cultura, or the search page link.

Examples:

harry potter
https://www.cultura.com/search/results?search_query=harry+potter

A product link (/p-....html) returns 400.

page?number

Page number, starting at 1. For example, 2 returns the next page of results.

When query is a search link, a number above 1 replaces the page in that link.

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/cultura/search?query=string'
Example Response
{  "results": [    {      "sku": "13432454",      "url": "https://www.cultura.com/p-harry-potter-a-l-ecole-des-sorciers-9782075253147.html",      "name": "Harry Potter à l'école des sorciers",      "badge": "Précommande",      "brand": "J. K. Rowling",      "image": "https://cdn.cultura.com/media/pim/13432454_8wuv0xn9_1_95486",      "price": 8.95,      "rating": null,      "currency": "EUR",      "position": 1,      "availability": "Précommande - sortie le 05/11/26",      "review_count": null,      "price_display": "8,95 €",      "new_offers_count": null,      "new_offers_price": null,      "used_offers_count": null,      "used_offers_price": null,      "new_offers_price_display": null,      "used_offers_price_display": null    }  ],  "pagination": {    "next": "https://www.cultura.com/search/results?search_query=harry+potter&page=2",    "page": 1,    "per_page": 60,    "total_pages": 50,    "total_results": 3371  }}