Piloterr

Point.P Search

GET
/v2/pointp/search

Point.P Search API: search by keyword or URL and get building-material listings with prices, brands, ratings, units, and pagination as JSON via browser rendering.

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

Search keyword or full Point.P search results URL.

Example (keyword):

colle

Resolves to https://www.pointp.fr/search?q=colle.

Example (search URL):

https://www.pointp.fr/search?q=colle

Example (page 2):

https://www.pointp.fr/search/page-2?q=colle

Accepted URL patterns: /search, /search/page-{n} with param q

Notes:

  • Pass a keyword or copy the full search URL from pointp.fr.
  • Use page to override the page number, or paginate via pagination.next.
  • Use each result listing_url with Point.P Product for full PDP data.
page?number

1-based page number for pagination. Overrides the page inferred from the URL. Defaults to 1 when omitted.

Example: 2

return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

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/pointp/search?query=string'
Example Response
{  "results": [    {      "unit": "Sac-sachet",      "brand": "ULTIBAT",      "price": 37.82,      "title": "Colle Flex polyvalente - C2S1 ET/G - gris - sac de 25 kg",      "rating": 5,      "currency": "EUR",      "image_url": "https://www.pointp.fr/asset/29/81/AST2272981-M.jpg",      "reference": "7147449",      "product_id": "A7147449",      "listing_url": "https://www.pointp.fr/p/decoration-interieure/mortier-colle-flex-polyvalent-ultibat-c2s1-et-g-25kg-gris-A7147449",      "review_count": 3    },    {      "unit": "Sac-sachet",      "brand": "WEBER",      "price": 41.74,      "title": "Colle pour carrelage webercol flex enaé - gris - sac de 25 kg",      "rating": 5,      "currency": "EUR",      "image_url": "https://www.pointp.fr/asset/46/89/AST17024689-M.jpg",      "reference": "3596886",      "product_id": "A3596886",      "listing_url": "https://www.pointp.fr/p/decoration-interieure/mortier-colle-deformable-non-irritant-pour-carrelage-weber-col-A3596886",      "review_count": 1    },    {      "unit": "Pièce",      "brand": "WEBER",      "price": 29.24,      "title": "Mortier-colle webercol grès pour tous carreaux - blanc - sac de 25 kg",      "rating": 5,      "currency": "EUR",      "image_url": "https://www.pointp.fr/asset/44/78/AST17024478-M.jpg",      "reference": "3900577",      "product_id": "A3900577",      "listing_url": "https://www.pointp.fr/p/decoration-interieure/mortier-colle-a-adherence-amelioree-pour-carrelage-c2-weber-col-A3900577",      "review_count": 1    }  ],  "pagination": {    "next": "https://www.pointp.fr/search/page-2?q=colle",    "page": 1,    "per_page": 24,    "total_pages": 49,    "total_results": 1165  }}

Point.P Product GET

Anterior

PR Newswire Article GET

Siguiente