YepAPI/skills

YepAPI — API 참조

기본 URL: https://api.yepapi.com
인증: x-api-key 헤더
응답: { ok: true, data: {...} } 또는 { ok: false, error: { code, message } }
속도 제한: 분당 60개 요청

SEO — 키워드

메서드	경로	비용	필수	설명
POST	/v1/seo/keywords	$0.15	keywords[], location	대량 메트릭: 검색량, CPC, 난이도, 의도, 트렌드 (최대 100개)
POST	/v1/seo/keywords/ideas	$0.03	keyword, location	시드 키워드 기반 키워드 제안
POST	/v1/seo/keywords/related	$0.03	keyword, location	시드 키워드의 연관 키워드

반환: volume, cpc, difficulty (0-100), intent (정보/상업/탐색/거래), trend (12개월 배열)

SERP

메서드	경로	비용	필수	설명
POST	/v1/serp/google	$0.01	query, location	Google 유기적 검색 결과
POST	/v1/serp/google/news	$0.01	query, location	Google 뉴스 결과
POST	/v1/serp/google/maps	$0.01	query, location	Google 지도 / 지역 결과

반환: results[] (각각 title, url, snippet, position 포함). Maps는 rating, reviews, address, phone 추가.

도메인 분석

메서드	경로	비용	필수	설명
POST	/v1/seo/domain/overview	$0.01	domain	트래픽, 키워드, 백링크, 도메인 순위
POST	/v1/seo/domain/keywords	$0.04	domain	도메인이 순위를 갖는 키워드
POST	/v1/seo/domain/backlinks	$0.05	domain	도메인 백링크 프로필

반환: overview는 traffic, keywords_count, backlinks, domain_rank 제공. Keywords는 keyword, position, volume, url 제공.

경쟁사 분석

메서드	경로	비용	필수	설명
POST	/v1/seo/competitors	$0.04	domain	키워드 겹침 기반 경쟁사 도메인
POST	/v1/seo/keyword-gap	$0.04	domain, competitor	두 도메인 간 키워드 갭

반환: competitors는 domain, overlap, traffic 제공. Gap은 keyword, your_position, competitor_position, volume 제공.

백링크

메서드	경로	비용	필수	설명
POST	/v1/seo/backlinks	$0.05	target	도메인/URL의 개별 백링크
POST	/v1/seo/backlinks/summary	$0.03	target	집계 메트릭 + dofollow 비율
POST	/v1/seo/referring-domains	$0.03	target	권위(Authority)를 포함한 참조 도메인

반환: summary는 total_backlinks, dofollow_ratio, domain_rank 제공. Backlinks는 source_url, anchor, type, domain_rank 제공.

온페이지 및 트렌드

메서드	경로	비용	필수	설명
POST	/v1/seo/page-audit	$0.03	url	기술 SEO 감사 (메타, 제목, 링크, 이미지)
POST	/v1/seo/lighthouse	$0.05	url	Lighthouse 점수 (성능, 접근성, SEO, 모범 사례)
POST	/v1/seo/trends	$0.02	keywords[]	Google 트렌드 관심도 변화 (최대 5개 키워드)

반환: page-audit은 issues[], meta, headings, links, images 제공. Lighthouse는 performance, accessibility, seo, best_practices (0-100) 제공. Trends는 interest_over_time[] 제공.

AI 가시성

메서드	경로	비용	필수	설명
POST	/v1/seo/ai/chatgpt	$0.05	query	ChatGPT가 브랜드/쿼리에 대해 말하는 내용
POST	/v1/seo/ai/gemini	$0.05	query	Gemini가 브랜드/쿼리에 대해 말하는 내용

반환: response (텍스트), mentions[], sentiment.

웹 스크래핑

메서드	경로	비용	필수	설명
POST	/v1/scrape	$0.01	url	마크다운/HTML/텍스트로 스크래핑
POST	/v1/scrape/js	$0.02	url	JS 렌더링 스크래핑 (헤드리스 브라우저)
POST	/v1/scrape/stealth	$0.03	url	안티봇 우회 (리지덴셜 프록시)
POST	/v1/scrape/ai-extract	$0.03	url, prompt	AI 기반 구조화 추출

선택 사항: format ("markdown"/"html"/"text"), waitFor (CSS 선택자), timeout (ms).
반환: content (문자열), metadata (title, description, url).

YouTube

메서드	경로	비용	필수	설명
POST	/v1/youtube/search	$0.01	query	동영상, 채널, 재생목록 검색
POST	/v1/youtube/video	$0.02	videoId	전체 동영상 메타데이터 + 포맷
POST	/v1/youtube/transcript	$0.01	videoId	타임스탬프 포함 자막
POST	/v1/youtube/channel	$0.01	channelId 또는 handle	채널 개요
POST	/v1/youtube/comments	$0.01	videoId	댓글 및 답글

반환: search는 results[] (각각 videoId, title, views, published 포함). Transcript는 segments[] (각각 text, start, duration 포함).

AI 채팅

메서드	경로	비용	필수	설명
POST	/v1/ai/chat	변동	model, messages[]	69개 AI 모델과 채팅
GET	/v1/ai/models	무료	—	사용 가능한 모델 및 가격 목록

공통 선택 필드

SEO 엔드포인트: location (기본값 "us"), language (기본값 "en"), limit, offset.
스크래핑 엔드포인트: format, waitFor, timeout.

오류 코드

코드	HTTP	의미
INVALID_API_KEY	401	키가 없거나 올바르지 않음
REVOKED_API_KEY	401	키가 해지됨
NO_CREDITS	402	잔액 부족
RATE_LIMITED	429	분당 60회 초과
VALIDATION_ERROR	400	잘못된 요청 본문
UPSTREAM_ERROR	502	제공자 오류
MODEL_NOT_FOUND	400	잘못된 AI 모델
AI_UPSTREAM_ERROR	502	AI 제공자 오류
STREAM_ERROR	502	SSE 중단
NOT_FOUND	404	엔드포인트를 찾을 수 없음
INTERNAL_ERROR	500	서버 오류

링크

• 문서: https://docs.yepapi.com
• 대시보드: https://yepapi.com/dashboard
• API 키: https://yepapi.com/dashboard/api-keys
• 전체 참조: https://docs.yepapi.com/llms-full.txt
• MCP 서버: npx -y @yepapi/mcp