Apinoa API 문서
마켓플레이스 상품 데이터, 소셜 미디어 데이터, 검색 엔진 결과, AI 엔진 답변, 이미지 번역을 API 키 하나로 이용합니다. 모든 엔드포인트의 파라미터, 실제 응답, 에러 코드를 다룹니다.
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입니다. 모든 플랫폼이 키 하나 뒤에서 공통 스키마로 응답합니다. 플랫폼은 경로의 한 구간일 뿐이고, 나머지 연동 코드는 그대로입니다.
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안에서는 필드가 추가될 뿐 삭제되거나 이름이 바뀌지 않으므로(버전 관리), 한 번 작성한 코드가 계속 동작합니다. - 실패한 요청은 무료입니다. 실패한 호출은 과금되지 않습니다. 받은 데이터에만 비용을 냅니다.
- 요청당 과금. 선불 잔액에서 차감되며 구독은 없습니다. 엔드포인트마다 페이지에 가격이 나와 있습니다.
시작하기
시작하기
키를 만들고, 첫 호출을 보내고, 응답을 읽습니다.
인증
키는 x-api-key 헤더로 보내고, 서버에만 보관합니다.
SDK와 MCP
TypeScript·Python SDK, Claude Code·Codex·Cursor용 MCP 서버, OpenAPI 문서.
버전 관리
버전은 경로에 있습니다. v1이 보장하는 것과 추가될 수 있는 것.
에러
모든 에러 코드와 상태, 그리고 대처 방법.
Marketplace API
Overview
공통 오퍼레이션, 마켓플레이스별 지원 범위, 차이점을 읽는 법.
Response Schema
SearchResult, Product, ReviewPage, CategoryList, ShippingQuote의 필드별 설명.
Filters
모든 마켓플레이스에 공통인 필터 어휘와, 각 마켓플레이스가 받는 필터.
SNS API
Overview
공통 오퍼레이션 8개, 플랫폼별 지원 범위, 공통 입력 이름.
Response Schema
Account, Post, Comment, Group, Page의 필드별 설명.
SERP API
Overview
검색 엔진 16개, 지도, 앱 스토어, Google Trends. 공통 오퍼레이션과 엔진별 지원 범위.
Response Schema
ResultsPage, Suggestions, Place, App, Trends 등의 필드별 설명.
AI Answers API
Overview
AI 엔진 6개를 answer 오퍼레이션 하나로. 국가, 대화, 결과 유형.
Response Schema
Answer 타입: 본문, 인용, 출처, 카드, 언급의 필드별 설명.