---
title: API Endpoints
description: The AnydealsUK API provides a set of structured, secure endpoints that allow you to access deal feeds. In future, it will enable you to validate your account status, retrieve network configuration details, and perform utility operations such as link validation.…
url: "https://anydealsuk.com/kb/api-endpoints/"
updated: "2025-12-23"
category: "API & Developer Documentation"
tags:
  - api endpoints
  - developer docs
---

# API Endpoints

The AnydealsUK API provides a set of structured, secure endpoints that allow you to access deal feeds. In future, it will enable you to validate your account status, retrieve network configuration details, and perform utility operations such as link validation. This page lists all available endpoints, explains their purpose, and provides example usage.

---

# **1. Base URL**

All API endpoints begin with the following base URL:

```
https://anydealsuk.com/api/v1/
```

---

# **2. Authentication Requirement**

Every API request must include a valid API key.

### **Option A — Bearer Header** (recommended)

```
Authorization: Bearer YOUR_API_KEY
```

### **Option B — Embedded API Key in Feed URLs**

(Some feed URLs include the key directly.)

```
/feeds/{API_KEY}/{type}/{interval}.csv
```

If authentication fails, the API will return `401 Unauthorized`.

---

# **3. Feed Endpoints**

These endpoints provide access to your personalised monetised deal feeds.

Feeds support: **CSV, JSON, RSS**

---

## **3.1 Main Multi-Network Feed**

Includes Amazon, AWIN, Skimlinks, and all supported networks.

**Format:**

```
GET /feeds/{API_KEY}/main/{interval}.{format}
```

### **Intervals:**

- `10m`
- `30m`
- `60m`

### **Formats:**

- `csv`
- `xml`
- `json`
- `rss`

**Example:**

```
https://anydealsuk.com/api/v1/feeds/ABC123/main/10m.csv
```

---

## **3.2 Amazon-Only Feed**

Exclusive Amazon deals rewritten with your Amazon tracking ID.

**Format:**

```
GET /feeds/{API_KEY}/amazon/{interval}.{format}
```

**Example:**

```
https://anydealsuk.com/api/v1/feeds/ABC123/amazon/30m.json
```

---

# **4. Account & Status Endpoints** (Developmental)

These endpoints help you verify account status, subscription details, and API key validity.

---

## **4.1 Account Status**

Returns your subscription tier, plan group (Amazon / Pro), and API permissions.

```
GET /status
Authorization: Bearer YOUR_API_KEY
```

### **Example Response:**

```
{
  "account_status": "active",
  "subscription": "Ultra Pro",
  "refresh_interval": "10m",
  "networks_enabled": ["amazon", "awin", "skimlinks", "cj", "rakuten"],
  "rate_limit": 300
}
```

---

## **4.2 Network Configuration State**

Returns your configured affiliate IDs and enabled networks.

```
GET /networks
Authorization: Bearer YOUR_API_KEY
```

### **Includes:**

- Amazon tracking ID
- AWIN Publisher ID + API token status
- Skimlinks Site ID
- Custom `.go` domain
- Other network IDs (CJ, Rakuten, Webgains, etc.)

---

# **5. Utility Endpoints**

Helpful for testing, debugging, or validating links.

---

## **5.1 Validate a URL**

Checks how AnydealsUK would process a given link.

```
POST /validate/link
Authorization: Bearer YOUR_API_KEY
```

### **Payload:**

```
{
  "url": "https://www.currys.co.uk/product/example"
}
```

### **Response Example:**

```
{
  "merchant": "Currys",
  "network_used": "awin",
  "rewritten_url": "https://www.awin1.com/cread.php?...",
  "approved": true
}
```

---

## **5.2 API Health Check**

Confirms the API is online.

```
GET /health
```

### **Response:**

```
{
  "status": "ok",
  "timestamp": 1700000000
}
```

---

# **6. Error Response Format**

All errors follow a consistent JSON response.

### **Example Error:**

```
{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "code": 401
}
```

---

# **7. Future API Endpoints (Planned)**

The AnydealsUK API will expand over time, including:

- **Category-based feeds** (e.g., Amazon Tech only)
- **Search endpoint** for filtering by keyword
- **Price filters**
- **Developer webhooks** for deal events

---

# **8. Summary**

The AnydealsUK API includes endpoints for feeds, account status, network configuration, and link validation. It is lightweight, secure, and designed for scalable integration with websites, bots, automation tools, and enterprise applications.

The next page will cover **API Response Examples** i