Skip to content
Scrappa Get API key
John Lewis API 1 credit / request

John Lewis Product Search API Documentation

GET https://scrappa.co/api/johnlewis/search

John Lewis Product Search API Documentation Search the public John Lewis catalogue by query. Returns product ids, titles, brands, GBP prices, ratings, review counts, images and availability. Pass a product_id from a card to the product and reviews endpoints. Page, price bounds and sort are honoured on every response. Cards carry the current price, original_price and on_sale. An empty result, a broad query that lands on a category hub, an out-of-range page or a price filter with no matches returns a non-billable 422. 1 credit per successful request; failed requests are free. Price bounds apply to the cards of the requested page only. Only relevance sort is supported; other sort values return 422.

John Lewis Product Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/johnlewis/search
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops
Response preview
200 OK
{
    "data": {
        "page": 1,
        "sort": "relevance",
        "query": "kettle",
        "facets": [],
        "products": [
            {
                "brand": "John Lewis",
                "price": {
                    "max": 66.99,
                    "min": 66.99,
                    "was": 79.99
                },
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

4 optional filters available.

query string Required

Search text, 2 to 100 characters. Example: kettle.

Example value coffee shops
page integer Optional

Page number from 1 to 100. Defaults to 1.

Example value 1
sort string Optional

Only relevance is supported. Other values return 422.

Example value relevance
price_min number Optional

Applies to the cards of the requested page only. A card is kept when part of its price range lies inside the bounds.

Example value 10
price_max number Optional

Applies to the cards of the requested page only. A card is kept when part of its price range lies inside the bounds.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "page": 1,
        "sort": "relevance",
        "query": "kettle",
        "facets": [],
        "products": [
            {
                "brand": "John Lewis",
                "price": {
                    "max": 66.99,
                    "min": 66.99,
                    "was": 79.99
                },
                "title": "John Lewis Cordless Kettle",
                "images": [
                    "https://media.johnlewiscontent.com/is/image/JohnLewis/109711094"
                ],
                "rating": 4.5,
                "on_sale": true,
                "product_id": "109711094",
                "review_count": 1897,
                "original_price": 79.99,
                "available_to_order": true
            }
        ],
        "breadcrumb": [],
        "pagination": {
            "page": 1,
            "total": 81,
            "page_count": 1,
            "total_pages": 2,
            "has_next_page": true
        },
        "category_paths": []
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter is invalid, or the requested data is unavailable. Failed requests are never billed.

503

Upstream Unavailable

John Lewis could not be reached. Retry shortly.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.