Happy Endpoint

Get category page data from Tesco UK

Retrieve category page information from Tesco UK. Provide a category page URL to get structured data about products in that category.

GET
/category-page

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

categoryId*string
  • Tesco category ID/facet (e.g., b;RnJlc2glMjBGb29k for Fresh Food)
  • Get the categoryID from Helper/get-category-id endpoint
Length1 <= length <= 300
pageNo?integer

Page number for pagination (default: 1)

Default1
Range1 <= value

Header Parameters

X-RapidAPI-Host*string
Default"tesco-data-api.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/category-page?categoryId=b%3BRnJlc2glMjBGb29k" \  -H "X-RapidAPI-Host: tesco-data-api.p.rapidapi.com"
{
  "success": true,
  "data": {
    "categoryId": "b;RnJlc2glMjBGb29k",
    "pageNo": 1,
    "pageInformation": {
      "totalResults": 14,
      "currentPage": 1,
      "resultsOnPage": 14,
      "resultsPerPage": 24
    },
    "products": [
      {
        "id": "320816358",
        "tpnb": "96234274",
        "gtin": "05063445800654",
        "title": "Tesco Fire Pit Sweet and Smoky BBQ Chicken Drumsticks 900g",
        "brand": "FIRE PIT",
        "isForSale": true,
        "imageUrl": "https://digitalcontent.api.tesco.com/v2/media/ghs/d364d1d7-e6b1-4159-b48d-786904623902/901272b4-2839-476a-a023-332ce2565fde.jpeg?h=225&w=225",
        "price": {
          "price": 5,
          "unitPrice": 5.56,
          "unitOfMeasure": "kg"
        },
        "promotions": [
          {
            "description": "Any 2 for £8 Clubcard Price - Selected Tesco Bbq Meat & Rtc Products",
            "offerType": "CLUBCARD_PRICING",
            "startDate": "2025-03-24T00:00:00Z",
            "endDate": "2025-09-21T23:00:00Z"
          }
        ],
        "reviews": {
          "averageRating": 4.4,
          "reviewCount": 9
        },
        "categoryBreadcrumbs": [
          {
            "id": "b;RnJlc2glMjBGb29k",
            "name": "Fresh Food",
            "level": 0
          }
        ]
      }
    ]
  }
}
{
  "success": false,
  "message": "Invalid request: Query is required",
  "error": "VALIDATION_ERROR"
}
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}
{
  "success": false,
  "message": "Tesco API is currently unavailable. Please try again later.",
  "error": "TESCO_API_ERROR"
}

Get product details from Tesco UKGET

Retrieve detailed product information from Tesco UK. Provide a product ID or full product URL to get comprehensive product data including pricing, descriptions, and specifications.

Get category page data from Tesco IrelandGET

Retrieve category page information from Tesco Ireland. Provide a category page URL to get structured data about products in that category.