# Travis Perkins Scraper - UK Builders Merchant Prices and Specs (`studio-amba/travisperkins-scraper`) Actor

Scrape product data from travisperkins.co.uk, the UK builders merchant. Get prices with and without VAT, trade prices, promotions, categories, specifications, reviews, images and data sheets for over 20,000 products.

- **URL**: https://apify.com/studio-amba/travisperkins-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Travis Perkins Scraper

Pull product data from travisperkins.co.uk, the UK builders merchant. The actor returns one row per product with the price including and excluding VAT, the trade price, promotional prices, category path, specifications, reviews, images and data sheets.

Travis Perkins sells building materials, timber, plumbing, heating, electrical, decorating, tools, fixings and garden products. The data fits price monitoring against other UK merchants, assortment tracking and supplier price checks.

### How to scrape Travis Perkins data

There are three ways to tell the actor which products to read.

1. Fill `skus` with Travis Perkins product codes, for example `746914`. The code is the number after `/p/` in a product address.
2. Paste product pages into `productUrls`, for example `https://www.travisperkins.co.uk/emulsion-paints/dulux-trade-vinyl-matt-7-5l-pure-brilliant-white/p/746914`.
3. Leave both empty and fill `urlKeywords`. The actor reads the shop's public product sitemap and keeps products whose address contains one of your words, for example `emulsion`, `timber` or `dewalt`. Words are lowercase, as in the product addresses.

The actor stops at `maxResults`. If you leave everything empty, it reads the first 50 products in the sitemap.

The actor requests the product sitemap and the shop's product data endpoint. Search pages and category pages are not read.

### Input

| Field | Type | Description |
|---|---|---|
| `skus` | list of numbers | Travis Perkins product codes |
| `productUrls` | list of URLs | Travis Perkins product pages |
| `urlKeywords` | list of words | Used when no codes or URLs are given. Keeps products whose address contains one of the words |
| `maxResults` | number | Maximum number of products to return. Default 50 |
| `proxyConfiguration` | proxy | Apify Proxy settings. Default is Apify Proxy |

### What you get back

Each row is one product.

| Field | Description |
|---|---|
| `sku` | Travis Perkins product code |
| `name` | Product name |
| `brand` | Brand from the specification, when listed |
| `manufacturerModelNumber` | Manufacturer model number, when listed |
| `category` | Category path, top level first |
| `price` | Shop price including VAT in GBP |
| `priceExVat` | Shop price excluding VAT in GBP |
| `tradePrice` | Trade price including VAT, when the shop shows one |
| `tradePriceExVat` | Trade price excluding VAT |
| `tradePriceType` | `account` for an account price, `typical trade` for the typical trade price shown to guests |
| `priceOnApplication` | True when the shop shows no price and asks for a quote |
| `promotionTiers` | Promotional prices with minimum quantity, end date and message |
| `onPromotion` | True when at least one promotional price exists |
| `currency` | GBP |
| `vatRate` | VAT rate in percent |
| `priceUnit` | Unit the price applies to, for example each |
| `description` | Product description |
| `features` | Feature and benefit lines |
| `specifications` | Technical specifications as name and value pairs |
| `rating`, `reviewCount` | Average review rating and number of reviews |
| `dataSheets` | Data sheet names and links |
| `hireable` | True when the product can be hired |
| `imageUrl` | Main product image |
| `url` | Product page address |
| `scrapedAt` | Time of the scrape |
| `country`, `language` | `gb` and `en` |

### Example output

```json
{
  "sku": "820980",
  "name": "Dulux Trade Supermatt Emulsion Paint 5L White",
  "brand": "Dulux Trade",
  "category": "Decorating & Interiors > Paint > Emulsion Paints",
  "price": 50.77,
  "priceExVat": 42.31,
  "tradePrice": 45.7,
  "tradePriceType": "typical trade",
  "currency": "GBP",
  "vatRate": 20,
  "priceUnit": "each",
  "rating": null,
  "reviewCount": 0,
  "imageUrl": "https://dam-assets.apps.travisperkins.group/v16pnwg/GPID_1000139081_IMG_00.jpg",
  "url": "https://www.travisperkins.co.uk/emulsion-paints/dulux-trade-supermatt-emulsion-paint-5l-white/p/820980",
  "country": "gb",
  "language": "en"
}
```

### Use cases

- Price monitoring against other UK builders merchants and online DIY shops.
- Tracking trade price and shop price per product over time.
- Building a product catalogue with specifications, images and data sheets.
- Finding products on promotion with their minimum quantity and end date.
- Checking supplier and brand coverage in a category.

### Price fields

The shop shows a price including VAT. The actor also returns the price excluding VAT, taken from the shop's own data, so the two always match.

The trade price comes from the shop. Without an account the shop shows the typical trade price, and the actor labels it `typical trade` in `tradePriceType`. The actor does not log in, so account prices are not returned.

Some products have no price and ask for a quote. For those rows `priceOnApplication` is true and the price fields are empty.

### Cost

The actor reads product data directly from the shop, without a browser, so runs are cheap. A run of 300 products takes about three minutes. Pricing is per result. The usage cost of a run is final only after the run reaches SUCCEEDED, so read it after the run has finished.

### Speed and limits

- The product sitemap lists more than 20,000 products. Use `urlKeywords` or `skus` to read a part of it.
- The actor reads several products at the same time and retries a failed request up to three times.
- If the shop does not answer before the run time limit, the actor ends the run with the rows saved so far.
- Products removed from the shop since the sitemap was published are skipped.

### Tips

- Use `skus` to refresh a fixed list of products every day.
- Use `urlKeywords` with a brand name to read all products of that brand.
- Compare `price` with `tradePrice` to see the typical trade discount.
- Export to JSON, CSV or Excel from the Apify console, or read the dataset through the API.

### Data source and legal

The actor reads publicly visible product data from travisperkins.co.uk without login. It uses the product sitemap listed in robots.txt and the shop's own product data endpoint, and it does not read the paths robots.txt disallows. Respect the shop's terms of use and the data protection rules that apply to how you use the data. Product data contains no personal data.

### Support

If a field comes back empty for products that show it on the website, open an issue on the actor page with the product code and we will look at it.

# Actor input Schema

## `productUrls` (type: `array`):

Product pages from travisperkins.co.uk, for example https://www.travisperkins.co.uk/emulsion-paints/dulux-trade-vinyl-matt-7-5l-pure-brilliant-white/p/746914. Leave empty to read the shop's product list.

## `skus` (type: `array`):

Travis Perkins product codes, the number after /p/ in a product URL, for example 746914. Use this to look up exact products.

## `urlKeywords` (type: `array`):

Used when no product URLs or codes are given. The actor reads the shop's product list and keeps products whose URL contains one of these words, for example emulsion or timber. Words are lowercase. Leave empty to read the first products in the list.

## `maxResults` (type: `integer`):

Maximum number of products to return.

## `proxyConfiguration` (type: `object`):

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "urlKeywords": [
    "emulsion"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urlKeywords": [
        "emulsion"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/travisperkins-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urlKeywords": ["emulsion"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/travisperkins-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urlKeywords": [
    "emulsion"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/travisperkins-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/travisperkins-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/p0eM4oUx2Fr5pRTfe/builds/VBuHHUnBBjCubb1E2/openapi.json
