---
title: Apinoa API 문서
description: "마켓플레이스 상품 데이터, 소셜 미디어 데이터, 검색 엔진 결과, AI 엔진 답변, 이미지 번역을 API 키 하나로 이용합니다. 모든 엔드포인트의 파라미터, 실제 응답, 에러 코드를 다룹니다."
---

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

Apinoa는 **마켓플레이스 상품 데이터**(Amazon, Shopify, Walmart, TikTok Shop, AliExpress), **소셜 미디어
데이터**(Reddit, TikTok, YouTube, Instagram, Threads, LinkedIn, X), **검색 엔진 결과**(Google, Bing, Naver, Baidu,
Yandex 등), **AI 엔진 답변**(ChatGPT, Gemini, Google AI Mode·AI 개요, Naver), **이미지 번역**을 하나로 묶은 API입니다. 모든 플랫폼이
키 하나 뒤에서 공통 스키마로 응답합니다. 플랫폼은 경로의 한 구간일 뿐이고, 나머지
연동 코드는 그대로입니다.

```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): 공통 오퍼레이션 8개, 플랫폼별 지원 범위, 공통 입력 이름.
- [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 엔진 6개를 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): 디자인은 그대로 두고 상품 이미지 속 텍스트를 바꿉니다.