Poshmark Listings API

Search live Poshmark listings by keyword or URL — get titles, prices, discounts, sizes, brands, images, and links as structured JSON with cursor pagination.

原始信息汇总

数据集概述：Poshmark Listings API

该API用于实时搜索和获取Poshmark平台（一个主营新品和二手时尚商品的社交电商平台）上的商品列表数据，并以结构化JSON格式返回。

核心功能

• 搜索方式：支持通过关键词（query）或完整的Poshmark搜索/分类URL（url）进行查询。
• 数据内容：每个商品列表包含标题、当前价格、原价、尺码、品牌、图片链接和商品详情链接。
• 分页机制：采用游标（cursor）分页，每个响应返回一个nextMaxId，用于获取下一页数据，直到nextMaxId为null表示最后一页。
• 响应速度：热查询响应时间约1-2秒，数据直接以结构化JSON返回，无需客户端进行HTML解析。

接口详情

• 端点：GET /search
• 请求参数：
  • query (string, 可选)：自由文本搜索关键词（如 Nike shoes）。如果同时提供了url，则该参数被忽略。
  • url (string, 可选)：完整的Poshmark搜索或分类URL（如 https://poshmark.com/brand/Nike-Men），优先级高于query。
  • maxId (string, 可选)：分页游标，用于获取下一页数据。
  • 注意：query 和 url 至少需要提供其中一个。
• 返回参数（JSON格式）：
  • url (string)：实际抓取的Poshmark URL。
  • count (number)：当前页面的商品数量。
  • nextMaxId (string | null)：下一页的游标，null表示已到最后一页。
  • products (array)：当前页面的商品列表，每个商品包含以下字段：
    • link (string)：商品的Poshmark详情链接。
    • image (string | null)：商品主图URL。
    • title (string | null)：商品标题。
    • price (string | null)：当前售价（包含货币符号，如 $11）。
    • oldPrice (string | null)：折扣前的原价。
    • size (string | null)：商品尺码。
    • brand (string | null)：品牌名称（如果Poshmark标签页上有显示）。

应用场景

• 二手转售价格追踪
• 库存货源搜索
• 转售商及跨平台刊登工具开发
• 时尚市场分析

认证与错误处理

• 认证：需要通过RapidAPI平台发送X-RapidAPI-Key和X-RapidAPI-Host头。
• 错误码：
  • 400：missing_param，即未提供query或url参数。
  • 502：scrape_failed，上游请求失败，建议重试。
• 其他说明：该API为非官方API，与Poshmark无关联，数据用于研究和分析目的。