문서 검색
1 크레딧/v1/wikipedia/search검색어에 맞는 문서를 언어별로 반환하며, 각 문서의 페이지 ID, 제목, 링크, 일치하는 구절의 일반 텍스트, 단어 수, 마지막 변경 시각이 포함됩니다. 페이지당 최대 50개, 100페이지까지 Wikipedia의 전체 결과 수와 함께 조회합니다. 표준 티어(1 크레딧)입니다.
query, language, page, limit
모든 언어판 Wikipedia를 읽는 엔드포인트는 2개입니다. 키워드로 검색한 뒤 문서 하나를 전체로 읽습니다.
/v1/wikipedia/search검색어에 맞는 문서를 언어별로 반환하며, 각 문서의 페이지 ID, 제목, 링크, 일치하는 구절의 일반 텍스트, 단어 수, 마지막 변경 시각이 포함됩니다. 페이지당 최대 50개, 100페이지까지 Wikipedia의 전체 결과 수와 함께 조회합니다. 표준 티어(1 크레딧)입니다.
query, language, page, limit
/v1/wikipedia/article제목이나 링크로 문서 하나를 반환합니다. 섹션 제목이 포함된 일반 텍스트 전체 문서, 페이지 ID, 링크, 리비전 ID, 마지막 변경 시각, 크기, 동음이의어 문서 여부가 포함됩니다. 넘겨주기는 따라갑니다. Wikipedia에 없는 제목은 404를 반환하며 과금되지 않습니다. 표준 티어(1 크레딧)입니다.
title or url, language
Wikipedia 문서 하나를 언어와 상관없이 일반 텍스트로 반환하고 페이지 ID, 링크, 리비전, 동음이의어 문서 여부를 함께 제공합니다.
리서치나 요약, 개체 조회, AI 답변의 근거 자료로 문서 전체를 읽을 때 사용하세요.
1크레딧
$ curl https://www.socialcrawl.dev/v1/wikipedia/article?title=Python+%28programming+language%29 \
-H "x-api-key: sc_YOUR_API_KEY"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Wikipedia도 SocialCrawl의 일반 데이터 표면입니다. API 키로 GET /v1/wikipedia/…를 호출하고, 실시간 조회에만 크레딧을 쓰며, 하나의 JSON 응답 형식을 받습니다.
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Wikipedia 계정은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
검색은 query, language, page, limit을 받습니다. 문서는 title이나 url과 language를 받습니다. 과금 전에 형식을 검증합니다.
모든 Wikipedia 경로는 1 크레딧입니다. 캐시 적중은 0 크레딧입니다.
모든 응답은 success, data, credits_used, credits_remaining, request_id, cached로 같은 형태입니다. 페이지가 있는 경로의 목록에는 pagination이 함께 담깁니다.
대부분 제품은 주제를 한 번 검색한 뒤 필요한 문서를 전체로 읽습니다.
GET /v1/wikipedia/search?query=…제목, 구절, 단어 수가 담긴 문서 PostList
알맞은 문서나 이름의 알맞은 의미를 찾습니다.
GET /v1/wikipedia/article?title=…일반 텍스트 전체 문서가 담긴 Post
한 번의 호출로 섹션별로 나누기 쉬운 본문을 받습니다.
GET /v1/wikipedia/article?title=…&language=de다른 언어판의 같은 주제 Post
언어마다 별도의 Wikipedia와 문서가 있습니다.
GET /v1/wikipedia/search?query=python+programming
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/wikipedia/article?title=Python+(programming+language){
"success": true,
"data": {
"post": {
"id": "23862",
"url": "https://en.wikipedia.org/wiki/Python_(programming_language)",
"content": { "text": "Python is a high-level, general-purpose programming language. ..." },
"ext": {
"title": "Python (programming language)",
"wikipedia": { "language": "en", "is_disambiguation": false, "revision_id": "1386743958" }
}
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}아키타입이 같으면 필드 이름도 SocialCrawl 전체와 같습니다. 한 번 파싱해 모든 플랫폼에 재사용합니다.
items[]에 post.id(페이지 ID), ext.title, url, content.text(일치하는 구절), ext.wikipedia word_count, updated_at
content.text(일반 텍스트), ext.title, url, ext.wikipedia language, is_disambiguation, revision_id가 담긴 문서
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기를 따릅니다. Wikipedia는 별도 부가 기능이 아닙니다.
Next.js catch-all 경로가 Hono social API로 전달합니다. request_id를 발급하고 키를 인증한 뒤 속도 제한(분당 600회)과 동시성(키당 50건)을 적용합니다.
레지스트리에서 wikipedia 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 실행합니다. 잘못된 입력은 과금 없이 400을 반환합니다. 유효한 호출은 조회 전에 티어 비용을 원자적으로 차감합니다.
platform, resource, params로 결정적 캐시 키를 만듭니다. 적중하면 즉시 반환하고 credits_used는 0입니다. 미스이면 공개 데이터를 실시간으로 읽으며, 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커가 작동합니다.
Wikipedia 데이터를 Post와 PostList 아키타입으로 매핑하고 Wikipedia 고유 정보는 ext.wikipedia에 담아 검증한 뒤, 성공 응답으로 감싸 과금 감사용으로 기록합니다.
운영에서 중요한 과금 규칙
Wikipedia 데이터는 공개 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 공급사 SDK를 익힐 필요가 없습니다.
모든 언어판 Wikipedia의 공개 문서와 각 문서의 페이지 ID, 리비전, 링크입니다.
공개 데이터를 요청 시 각 소스의 공개 이용 규칙 안에서 읽어 서버에서 정규화합니다.
검색은 PostList, 문서는 Post로 공통 형태입니다. Wikipedia 고유 정보는 ext.wikipedia에 담깁니다.
편집, 토론 문서, 사용자 계정, 문서 역사는 제공하지 않습니다.
이 API가 가장 많이 쓰이는 작업입니다.
리서치, 개체 조회, AI 답변의 근거 확보
호출하는 쪽은 주제나 이름을 검색한 뒤 필요한 문서를 작업하는 언어로 전체 읽습니다. 모든 언어의 문서 전체를 일반 텍스트로 공통 Post 스키마에 담아 카탈로그 전체와 같은 키로 제공합니다.
캐시 미스는 공개 소스를 요청 시 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 처리됩니다.
팀이 이 데이터를 활용하는 대표적인 방식과 주로 쓰는 기술 스택입니다.
주제로 search를 호출한 뒤 article로 문서를 읽어 출처가 있는 답변의 근거로 씁니다.
기업이나 인물로 search를 호출하고 동음이의어 여부를 확인한 뒤 알맞은 문서를 읽습니다.
같은 주제를 여러 언어로 article로 읽어 언어판마다 다루는 내용을 비교합니다.
모든 Wikipedia 경로는 1 크레딧입니다. 캐시 적중은 무료입니다.
curl "https://www.socialcrawl.dev/v1/wikipedia/search?query=python%20programming" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/wikipedia/article?title=Python%20(programming%20language)" \
-H "x-api-key: sc_your_api_key_here"모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요