Piloterr

RS Online Search

GET
/v2/rsonline/search

Search RS Online UK by keyword or category. Pound prices keep the amount printed on the page.

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

A keyword, or a uk.rs-online.com search or category link. Empty, another host, or a product link returns 400. A keyword builds /web/c/?searchTerm=... and page 1 omits pn. Each card has price as a number and price_display as the pound string.

Keyword

connector

Category link

https://uk.rs-online.com/web/c/connectors/
page?number

Page number starting at 1. Omit it for page 1. Page 2 sets pn=2, changes pagination.page, and returns the next cards. pagination.next is that next URL, or null on the last page. A value below 1 returns 400.

Range1 <= value
return_page_source?boolean

Default false. true replaces results and pagination with result, the rendered HTML.

Antworttext

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/rsonline/search?query=string'
Example Response
{  "results": [    {      "mpn": "221-2401",      "url": "https://uk.rs-online.com/web/p/splice-connectors/0303327",      "brand": "WAGO",      "price": 4.95,      "title": "WAGO, 221 Wire Splice Splice Connector, Clear, Insulated 12 AWG",      "category": "Splice Connectors",      "currency": "GBP",      "in_stock": true,      "image_url": "https://media.rs-online.com/t_large/Y0303327-01.jpg",      "pack_size": 10,      "product_id": "0303327",      "stock_status": "IN_STOCK",      "price_display": "£4.95",      "rs_stock_number": "030-3327",      "minimum_order_qty": 1    }  ],  "pagination": {    "next": "https://uk.rs-online.com/web/c/?searchTerm=connector&pn=2",    "page": 1,    "per_page": 20,    "total_pages": 3220,    "total_results": 64395  }}