---
title: Apinoa API 文档
description: "一个 API 密钥，获取电商平台商品数据、社交媒体数据、搜索引擎结果、AI 引擎回答和图片翻译：每个接口的参数、真实响应与错误代码。"
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt)

Apinoa 是一个统一的 API，提供**电商平台商品数据**（Amazon、Shopify、Walmart、TikTok Shop、AliExpress）、**社交媒体
数据**（Reddit、TikTok、YouTube、Instagram、Threads、LinkedIn、X）、**搜索引擎结果**（Google、Bing、Naver、百度、
Yandex 等）、**AI 引擎回答**（ChatGPT、Gemini、Google AI Mode 和 AI 概览、Naver）和**图片翻译**。所有平台都以共享的结构
返回，使用同一个密钥：平台只是路径中的一段，集成的其余部分保持不变。

```bash
curl "https://gateway.apinoa.com/v1/amazon/search?query=wool+socks" -H "x-api-key: $APINOA_API_KEY"
curl "https://gateway.apinoa.com/v1/tiktok/posts?username=tiktok" -H "x-api-key: $APINOA_API_KEY"
curl "https://gateway.apinoa.com/v1/google/search?q=wool+socks" -H "x-api-key: $APINOA_API_KEY"
```

## 直接调用 API，不必自己写爬虫

- **一次调用，一个结果。** 一个请求就以 JSON 返回数据：无需运行浏览器，也无需解析 HTML。
- **每个类别一套结构。** Amazon 商品与 Walmart 商品的字段相同；Google 与 Bing 的搜索结果页、TikTok 与 YouTube
  的帖子、ChatGPT 与 Gemini 的回答也是如此。
- **结构保持不变。** 在 `v1` 内，字段只会新增，不会删除或改名（[版本管理](/docs/versioning)），写好的代码会一直可用。
- **失败的请求免费。** 失败的调用不计费：只为收到的数据付费。
- **按请求付费。** 从预付余额中扣除，没有订阅。每个端点的页面都写明了价格。

## 开始使用

- [快速入门](https://apinoa.com/en/docs/getting-started): 创建密钥，发出第一个调用并读取响应。
- [身份验证](https://apinoa.com/en/docs/authentication): 在 x-api-key 请求头中发送密钥，并将其保存在服务器端。
- [SDK 与 MCP](https://apinoa.com/en/docs/sdks): TypeScript 和 Python SDK、适用于 Claude Code、Codex 和 Cursor 的 MCP 服务器，以及 OpenAPI 文档。
- [版本管理](https://apinoa.com/en/docs/versioning): 版本位于路径中；v1 承诺什么，以及可能新增什么。
- [错误](https://apinoa.com/en/docs/errors): 每个错误代码、其状态码以及应对方法。

## Marketplace API

- [Overview](https://apinoa.com/en/docs/api-reference/marketplaces): 共享的操作、各电商平台支持哪些，以及如何理解差异。
- [Response Schema](https://apinoa.com/en/docs/api-reference/marketplaces/response-schema): SearchResult、Product、ReviewPage、CategoryList 和 ShippingQuote，逐字段说明。
- [Filters](https://apinoa.com/en/docs/api-reference/marketplaces/filters): 所有电商平台通用的一套过滤器词汇，以及各平台接受哪些。

## SNS API

- [Overview](https://apinoa.com/en/docs/api-reference/sns): 八个共享操作、各平台支持哪些，以及它们共用的输入名称。
- [Response Schema](https://apinoa.com/en/docs/api-reference/sns/response-schema): Account、Post、Comment、Group 和 Page，逐字段说明。

## SERP API

- [Overview](https://apinoa.com/en/docs/api-reference/serp): 16 个搜索引擎、地图、应用商店和 Google Trends：共享的操作，以及各引擎支持哪些。
- [Response Schema](https://apinoa.com/en/docs/api-reference/serp/response-schema): ResultsPage、Suggestions、Place、App、Trends 等，逐字段说明。

## AI Answers API

- [Overview](https://apinoa.com/en/docs/api-reference/answers): 六个 AI 引擎，一个 answer 操作：国家、对话与结果类型。
- [Response Schema](https://apinoa.com/en/docs/api-reference/answers/response-schema): Answer 类型：正文、引用、来源、卡片和提及，逐字段说明。

## 其他 API

- [Image Translate](https://apinoa.com/en/docs/api-reference/image-translate): 替换商品图片中的文字，同时保留原有设计。