> ## Documentation Index
> Fetch the complete documentation index at: https://docs.api.ehunt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 欢迎使用 EHunt API

> 强大的 Etsy 数据查询 API 服务

<img className="block dark:hidden" src="https://mintcdn.com/ehunt/zPvuuBzR8fNVgbDY/images/d1e8100f8cd02b0b52bcf59575f5d167.png?fit=max&auto=format&n=zPvuuBzR8fNVgbDY&q=85&s=88e606e76d7af0dd36bfcd745b3bf267" alt="EHunt Logo" style={{ maxWidth:"200px",margin:"0 auto 2rem" }} width="174" height="60" data-path="images/d1e8100f8cd02b0b52bcf59575f5d167.png" />

# EHunt API

EHunt API 为 VIP 用户提供强大的 Etsy 商品和店铺数据查询服务，支持多维度筛选、排序与分页。

## 🚀 快速开始

<CardGroup cols={2}>
  <Card title="商品查询 API" icon="box" href="/api/items">
    查询 Etsy 商品数据，支持销量、价格、收藏等多维度筛选
  </Card>

  <Card title="店铺查询 API" icon="store" href="/api/stores">
    查询 Etsy 店铺数据，支持按国家、分类、评分等条件筛选
  </Card>
</CardGroup>

## ✨ 核心特性

<AccordionGroup>
  <Accordion title="多维度数据筛选">
    支持按销量、价格、收藏数、评论数等多个维度进行精确筛选，帮助你快速找到目标商品和店铺。
  </Accordion>

  <Accordion title="实时数据更新">
    提供最新的 Etsy 平台商品和店铺数据，确保你获得准确的市场信息。
  </Accordion>

  <Accordion title="灵活的排序与分页">
    自定义排序规则，支持大批量数据查询，最大程度满足你的分析需求。
  </Accordion>

  <Accordion title="透明的积分消费">
    按实际返回数据量计费，每条数据消耗1个积分，清晰透明的消费机制。
  </Accordion>
</AccordionGroup>

## 📊 API 概览

| API 类型 | 端点                     | 说明           |
| ------ | ---------------------- | ------------ |
| 商品查询   | `POST  /api/v1/items`  | 查询 Etsy 商品数据 |
| 店铺查询   | `POST  /api/v1/stores` | 查询 Etsy 店铺数据 |

## 🔑 认证方式

所有 API 请求需要在 Header 中携带有效的 API Key：

```bash theme={null}
X-VIP-TOKEN: your_api_key_here
```

<Note>
  请妥善保管你的 API Key，不要在公开场合泄露。
</Note>

## 💡 使用场景

<CardGroup cols={2}>
  <Card title="商品选品分析" icon="chart-line">
    发现高销量、高收藏的热门商品，找到市场机会
  </Card>

  <Card title="竞品监控" icon="eye">
    跟踪竞争对手的商品和店铺数据，了解市场动态
  </Card>

  <Card title="店铺调研" icon="magnifying-glass">
    筛选优质店铺，学习成功经验
  </Card>

  <Card title="市场趋势分析" icon="chart-mixed">
    分析市场规模和趋势，制定商业策略
  </Card>
</CardGroup>

## 🎯 开始使用

选择你需要的 API 接口，查看详细的文档和代码示例：

<CardGroup cols={2}>
  <Card title="查看商品查询 API" color="#16A34A" icon="arrow-right" href="/api/items">
    支持多种编程语言示例
  </Card>

  <Card title="查看店铺查询 API" color="#16A34A" icon="arrow-right" href="/api/stores">
    支持多种编程语言示例
  </Card>
</CardGroup>

***

<div style={{ textAlign:"center",marginTop:"3rem",color:"#666" }}>
  <p>需要帮助？联系 EHunt API 支持团队</p>
  <p style={{ fontSize:"0.875rem" }}>最后更新：2026-05-15</p>
</div>