Next.co.uk API

Access comprehensive Next.co.uk product data through a powerful scraper API. Extract detailed product information, sizing options, color variants, and pricing from the UK's leading fashion and homeware retailer with structured JSON responses for clothing, accessories, and home products.

原始信息汇总

Next.co.uk API 数据集概述

基本信息

• 数据集名称: Next.co.uk API
• 提供平台: RapidAPI
• API 提供者: clevo
• 类别: eCommerce (电子商务)
• 当前版本: 1.0.0
• API 类型: Scraper API (爬虫API)

API 功能概述

该API提供对英国领先的时尚和家居零售商Next.co.uk产品数据的程序化访问。它能够提取详细的产品信息，包括尺码可用性、颜色变体、合身选项、定价、品牌详情以及全面的产品图像。适用于构建时尚价格比较工具、库存管理系统、趋势分析平台或英国零售市场的竞争情报仪表板。

关键能力

• 全面的尺码和合身信息
• 带有可用性状态的颜色变体跟踪
• 包含多角度拍摄的详细产品图像
• 品牌和部门分类
• 价格历史和降价跟踪
• 洗涤说明和成分数据
• 基于系列的产品组织

订阅计划与性能指标

• 流行度: 8.6
• 服务等级: 100%
• 延迟: 1635ms
• 测试通过率: 100%
• 订阅计划:
  • BASIC: $0.00 / 月
  • PRO: $15.00 / 月
  • ULTRA: $49.00 / 月
  • MEGA: $139.00 / 月

API 端点

1. 通过URL获取产品详情

• 端点: POST /scrapers/api/next-co-uk/product/get-by-url
• 功能: 从Next.co.uk产品URL检索全面的产品信息。
• 请求体必需字段:
  • url (字符串): 完整的Next.co.uk产品URL，包括样式和商品标识符。

2. 通过URL获取产品列表

• 端点: POST /scrapers/api/next-co-uk/product/listing-by-url
• 功能: 从类别或搜索列表页面提取基本产品信息。
• 请求体必需字段:
  • url (字符串): 完整的Next.co.uk列表页面URL。

3. 搜索产品

• 端点: GET /scrapers/api/next-co-uk/product/search
• 功能: 使用关键词搜索Next.co.uk的目录，支持过滤和排序。
• 查询参数:
  • keyword (必需, 字符串): 搜索词 (例如: "dress", "shirt", "jeans", "shoes")。
  • sort_by (可选, 字符串): 排序方式。可选值: "score" (最相关)、"popular" (最受欢迎)、"title" (字母顺序A-Z)、"price" (价格从低到高)、"price rev" (价格从高到低)。
  • page (可选, 整数): 分页的页码 (从1开始，最小值为1)。

响应结构

API返回标准化的JSON响应以确保集成的一致性。

成功响应

json { "statusCode": 200, "messageCode": "OK", "data": [...] }

• statusCode: HTTP状态码 (200表示成功)
• messageCode: 状态描述
• data: 包含产品或搜索结果的数组

错误响应

json { "statusCode": 400, "messageCode": "BAD_REQUEST", "message": "Invalid URL format" }

• 错误码: 400 (错误请求), 404 (未找到), 500 (内部服务器错误)。

使用指南与最佳实践

• URL格式: 使用包含样式和商品哈希片段（例如 #a00951）的完整URL。
• 尺码跟踪: 解析options数组以获取所有变体的全面尺码可用性。
• 变体管理: 使用fits_and_colourways来跟踪跨颜色和合身选项的产品可用性。
• 图像资源: 利用item_media获取多个产品拍摄角度（主图、穿着场景、细节图）。
• 价格监控: 跟踪price_data对象以获取促销价格和价格范围。
• 库存管理: 监控options中的stock_status以获取实时可用性。
• 品牌过滤: 使用brand和department字段进行目录组织。

错误处理建议

• 400 错误请求: 验证URL是否包含完整的样式和商品标识符。确保搜索关键词编码正确。
• 404 未找到: 产品可能已下架或URL格式不正确。为不可用产品实施回退逻辑。
• 500 内部服务器错误: 使用指数退避的重试逻辑。建议最多尝试3-5次。

集成技巧

• 使用列表端点进行类别浏览；使用详情端点获取产品页面。
• 解析fits_and_colourways以进行跨变体导航和库存跟踪。
• 存储带有shot_type的item_media以组织图片库。
• 跟踪product_metadata中的category_links以进行面包屑导航。
• 监控markdown_type_v2和offer_type以获取促销活动信息。
• 使用composition和washing_instructions获取产品护理信息。
• 结合fits_and_colourways_item_number_map中的合身和颜色数据进行变体查找。
• 跟踪show_new_in和sale_sash指标以进行商品展示。

性能优化

• 列表和搜索端点返回轻量级数据，适用于目录视图。将详情端点保留给需要完整规格和尺码表的产品详情页。
• 对于搜索操作，利用sort_by参数优化结果相关性。
• 逐步实施分页，而不是批量获取所有页面。