# Screwfix — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Screwfix's full product catalog — browse category hierarchies, retrieve paginated product listings with pricing and ratings, fetch detailed product specifications, and search by keyword. Ideal for price monitoring, product research, and catalog analysis.

**Category:** E-commerce | **Website:** [screwfix.com/](https://screwfix.com/) | **Docs:** [parse.bot/marketplace/3f0e2625-0d7a-4d0e-9e5e-2543719ec733/screwfix-com-api](https://parse.bot/marketplace/3f0e2625-0d7a-4d0e-9e5e-2543719ec733/screwfix-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-screwfix-com-api-3f0e2625/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_products

Get products within a specific category. Returns paginated product listings with pricing, ratings, filters, and category metadata. Each page returns up to 20 products. The response includes totalProducts for computing page count. Use leaf-level category paths for product results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_url` | string | Yes | The full navigation path of the category including the category ID (e.g., /c/tools/drills/cat830704). Obtainable from get_top_level_categories navigationPath field. Use leaf-level categories for product results. |
| `page` | integer | No | Page number to fetch. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-screwfix-com-api-3f0e2625/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_url":"<string>","page":"<integer>"}'
```

### get_product_details

Get full details for a specific product by its URL path. Returns comprehensive product information including specifications, pricing, images, review count, and SEO metadata. Requires a product URL path with slug and SKU components.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | The URL path of the product including slug and SKU (e.g., /p/dewalt-dcd778p2t-sfgb-18v-2-x-5-0ah-li-ion-xr-brushless-cordless-combi-drill/906kv). Obtainable from get_category_products or search_products detailPageUrl field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-screwfix-com-api-3f0e2625/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"<string>"}'
```

### get_top_level_categories

Get the full category hierarchy from the main navigation menu. Returns an array of top-level categories, each containing nested children subcategories with their IDs, names, and navigation paths. Use the navigationPath to browse products in a category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-screwfix-com-api-3f0e2625/get_top_level_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Search for products by keyword. Returns paginated product listings with pricing, ratings, and filters. May return a redirect URL when the search term maps to a specific category page instead of direct results. Each page contains up to 20 products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to fetch. |
| `query` | string | Yes | Search keyword (e.g., 'hammer', 'cordless drill'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-screwfix-com-api-3f0e2625/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```