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