Piloterr

Darty Search

GET
/v2/darty/search

Search Darty by keyword or search URL and page through the listing. Each card has title, price, brand, seller, and product link.

Credit cost: 2 credits per call

Autorización

ApiKeyAuth
x-api-key<token>

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

In: header

Parámetros de consulta

query*string

Keyword or a Darty search URL on www.darty.com.

Examples:

aspirateur
https://www.darty.com/nav/recherche?text=aspirateur

A product URL returns 400. page replaces any offset already present in a search URL.

page?number

1-based page number. Defaults to 1. Page 2 returns the next 30 products.

Example: 2

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/darty/search?query=string"
{  "results": [    {      "url": "https://www.darty.com/nav/achat/petit_electromenager/aspirateur-avec_sac_sans_sac/aspirateur_sans_sac/rowenta_ro4b36.html",      "name": "Aspirateur sans sac Rowenta COMPACT POWER XXL Modele Parquet RO4B36EA",      "badge": "Bon Plan 21%",      "brand": "Rowenta",      "codic": "7522991",      "image": "https://image.darty.com/server?type=image&source=photos%2F2024%2F04%2F20%2F7522991A_211747457.jpg&width=230&height=345",      "price": 119.99,      "pickup": "Retrait dès le 05/11",      "rating": 4.4,      "seller": "Darty",      "category": "Aspirateur sans sac",      "currency": "EUR",      "delivery": "Livré dès le 05/11",      "position": 1,      "reference": "COMPACT POWER XXL Modele Parquet RO4B36EA",      "was_price": 151.99,      "shipped_by": null,      "review_count": 461,      "price_display": "119,99 €",      "rating_display": "4,4/5",      "discount_display": "21%",      "reparability_index": 9.8    }  ],  "pagination": {    "next": "https://www.darty.com/nav/recherche?s=relevence&text=aspirateur&o=30",    "page": 1,    "per_page": 30,    "total_pages": 300,    "total_results": 17644  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}