This page provides real-world examples of responses returned by the AnydealsUK API. Understanding these examples will help you integrate the API into your applications, bots, scripts, or import tools with confidence.

Responses include feed samples, status checks, network configuration output, error formats, and validation responses.

1. Feed Response Examples #

Feed endpoints return CSV, JSON, or RSS depending on the requested format.

Below are examples for each format.

1.1 CSV Feed Example (Main Feed) #

deal_id,title,description,price,merchant,affiliate_url,image_url,category,network,timestamp
473829,"Samsung 55\" 4K TV","Great price on a Samsung 55-inch TV",399.00,"Currys","https://www.awin1.com/cread.php?...","https://anydealsuk.com/images/2025/01/abc123.jpg","Electronics","awin","2025-01-12T10:25:00Z"
473830,"AirPods Pro (2nd Gen)","Discounted AirPods Pro at Amazon",199.00,"Amazon","https://www.amazon.co.uk/...&tag=yourtag-21","https://anydealsuk.com/images/2025/01/xyz789.jpg","Audio","amazon","2025-01-12T10:27:00Z"

1.2 JSON Feed Example #

{
    "deal_id": 473829,
    "title": "Samsung 55\" 4K TV",
    "description": "Great price on a Samsung 55-inch TV",
    "price": 399.00,
    "merchant": "Currys",
    "affiliate_url": "https://www.awin1.com/cread.php?...",
    "image_url": "https://anydealsuk.com/images/2025/01/abc123.jpg",
    "category": "Electronics",
    "network": "awin",
    "timestamp": "2025-01-12T10:25:00Z"
  },
  {
    "deal_id": 473830,
    "title": "AirPods Pro (2nd Gen)",
    "description": "Discounted AirPods Pro at Amazon",
    "price": 199.00,
    "merchant": "Amazon",
    "affiliate_url": "https://www.amazon.co.uk/...&tag=yourtag-21",
    "image_url": "https://anydealsuk.com/images/2025/01/xyz789.jpg",
    "category": "Audio",
    "network": "amazon",
    "timestamp": "2025-01-12T10:27:00Z"
  }
]

1.3 RSS Feed Example #

<rss version="2.0">
  <channel>
    <title>AnydealsUK Main Feed</title>
    <item>
      <title>Samsung 55" 4K TV</title>
      <link>https://www.awin1.com/cread.php?...</link>
      <description>Great price on a Samsung 55-inch TV</description>
      <pubDate>Sun, 12 Jan 2025 10:25:00 +0000</pubDate>
    </item>
  </channel>
</rss>

2. Status Endpoint Response Example (Developmental) #

This endpoint helps verify API key validity and subscription tier.

Request:

GET /status
Authorization: Bearer YOUR_API_KEY

Example Response:

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

3. Network Configuration Response Example (Developmental) #

Useful for verifying your affiliate ID setup.

Request:

GET /networks
Authorization: Bearer YOUR_API_KEY

Example Response:

{
  "amazon": {
    "tracking_id": "yourtag-21",
    "enabled": true
  },
  "awin": {
    "publisher_id": "123456",
    "api_token_set": true,
    "enabled": true
  },
  "skimlinks": {
    "site_id": "123456X111111",
    "custom_go_domain": "go.example.com",
    "enabled": true
  }
}

4. URL Validation Response Example (Developmental) #

This endpoint shows how a link is processed before rewriting.

Request:

POST /validate/link
{
  "url": "https://www.currys.co.uk/product/example"
}

Response:

{
  "merchant": "Currys",
  "network_used": "awin",
  "approved": true,
  "rewritten_url": "https://www.awin1.com/cread.php?...",
  "original_url": "https://www.currys.co.uk/product/example"
}

5. Error Response Examples (Developmental) #

The AnydealsUK API uses structured error messages.

401 Unauthorized #

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

403 Forbidden #

{
  "error": "Forbidden",
  "message": "Your subscription does not support this feed",
  "code": 403
}

429 Too Many Requests #

{
  "error": "Rate Limited",
  "retry_after_seconds": 60,
  "code": 429
}

500 Server Error #

{
  "error": "Server Error",
  "message": "Unexpected error occurred",
  "code": 500
}

6. Summary #

API responses are clean, predictable, and designed for easy parsing across all programming languages and services. These examples help developers quickly understand what to expect when integrating AnydealsUK feeds and functionality.

Next: API Rate Limits & Fair Usage.

End of Page 15