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

John Lewis Category Browse API Documentation

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

John Lewis Category Browse API Documentation Browse a live John Lewis category path. Use a category_paths entry from search, category or product. Both /browse/.../_/N- paths and /cNNNN landing paths are accepted. A landing resolves only to a complete view-all child, never to a facet-narrowed child; resolved_path reports the served path when cards come from that child. A child that does not match the requested category is rejected. A landing with no complete child, a category hub, an out-of-range page or a price filter with no matches returns a non-billable 422; no empty result is ever billed. category_paths lists only browse listings that replay to products. Returns product cards, facets, breadcrumb and category_paths. The resolution field says which path shape was served. 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 Category Browse API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/johnlewis/category
Auth header
x-api-key
Cost
1 credit / request
path = example
Response preview
200 OK
{
    "data": {
        "page": 1,
        "facets": [],
        "category": "browse/electricals/kettles/_/N-aht",
        "products": [
            {
                "price": {
                    "max": 66.99,
                    "min": 66.99,
                    "was": 79.99
                },
                "title": "John Lewis Cordless Kettle",
                "rating": 4.5,
...

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.

path string Required

Relative category path, for example browse/electricals/kettles/_/N-aht.

Example value example
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,
        "facets": [],
        "category": "browse/electricals/kettles/_/N-aht",
        "products": [
            {
                "price": {
                    "max": 66.99,
                    "min": 66.99,
                    "was": 79.99
                },
                "title": "John Lewis Cordless Kettle",
                "rating": 4.5,
                "on_sale": true,
                "product_id": "109711094",
                "review_count": 1897,
                "original_price": 79.99
            }
        ],
        "breadcrumb": [],
        "pagination": {
            "page": 1,
            "total": 64,
            "page_count": 1,
            "total_pages": 1,
            "has_next_page": false
        },
        "resolution": "listing",
        "category_paths": [
            {
                "name": "Kettles",
                "path": "browse/electricals/kettles/_/N-aht"
            }
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "category"
    },
    "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.