{ "openapi": "3.0.1", "info": { "title": "더쿠 스크래퍼｜HOT·스퀘어 게시글·댓글 수집 (API 불필요)", "description": "더쿠(theqoo.net) 게시판 글 목록과 게시글 본문·전체 댓글을 로그인·API 없이 수집합니다. HOT, 스퀘어, 케이돌토크, 아티스트별 게시판 지원. 댓글 번호, 같은 작성자 표시(=N덬), @답글 대상까지 정리하고 Cloudflare 보안 검사는 한국 주거용 프록시로 자동 처리합니다. JSON/CSV/Excel 내보내기, 케이팝·연예 여론 모니터링용.", "version": "1.0", "x-build-id": "5iY940FRAm5LFerwJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/claude_code_reviewer~theqoo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-claude_code_reviewer-theqoo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/claude_code_reviewer~theqoo-scraper/runs": { "post": { "operationId": "runs-sync-claude_code_reviewer-theqoo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/claude_code_reviewer~theqoo-scraper/run-sync": { "post": { "operationId": "run-sync-claude_code_reviewer-theqoo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "🎯 모드", "enum": [ "board", "thread" ], "type": "string", "description": "무엇을 수집할까요? 모드를 고른 뒤 아래 해당 칸을 채우세요.", "default": "board" }, "boards": { "title": "📋 게시판 ID", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "더쿠 게시판 ID(주소 theqoo.net/{ID}의 {ID} 부분)입니다. 예: hot(HOT), square(스퀘어), ktalk(케이돌토크), beauty(뷰티), dyb(드영배), talk(일상토크), 아티스트별 게시판(bts, newjeans, seventeen 등). 게시판 주소를 그대로 붙여 넣어도 됩니다. 게시판 모드에서 사용합니다.", "items": { "type": "string" } }, "threadIds": { "title": "💬 게시글 번호", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "게시글 번호(주소 theqoo.net/hot/{번호}의 숫자), 예: 4371268800. 게시글 전체 모드에서 사용합니다.", "items": { "type": "string" } }, "threadUrls": { "title": "💬 게시글 주소", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "게시글 전체 주소, 예: https://theqoo.net/hot/4371268800. 번호는 자동으로 추출됩니다.", "items": { "type": "string" } }, "bulkInput": { "title": "📋 한꺼번에 붙여넣기", "type": "string", "description": "**한 줄에 하나씩** 입력하세요(엔터로 줄바꿈, 따옴표나 쉼표 불필요). 모드에 따라 게시판 ID / 게시글 번호 / 주소로 자동 인식되어 위 칸에 합쳐집니다. 구글 시트나 엑셀의 열을 통째로 복사해 붙여 넣으면 가장 빠릅니다." }, "keywords": { "title": "🔍 제목 키워드 필터", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "(선택) 게시판 모드: 제목에 키워드가 하나라도 들어간 글만 남깁니다. 더쿠는 비회원 검색을 막아 두었기 때문에 사이트 전체 검색이 아니라, 수집한 게시판 목록의 제목을 걸러내는 방식입니다. 비워 두면 거르지 않습니다. 키워드를 쓰면 게시판마다 최대 20페이지(글 약 400개)까지만 훑고 멈춥니다.", "items": { "type": "string" } }, "maxItems": { "title": "📊 최대 개수", "minimum": 1, "maximum": 500, "type": "integer", "description": "게시판 모드: 게시판마다 수집할 최대 글 수. 게시글 전체 모드: 최대 게시글 수(댓글은 게시글마다 전부 수집하며, 제한하려면 '게시글당 최대 댓글 수'를 설정). 최대 500.", "default": 50 }, "maxReplies": { "title": "🧵 게시글당 최대 댓글 수 (선택)", "minimum": 0, "type": "integer", "description": "게시글 전체 모드에서 사용합니다. 게시글마다 1번 댓글부터 N번 댓글(댓글 번호 기준)까지만 수집합니다. 댓글은 comment-item 이벤트로 과금되며, 삭제된 댓글과 비회원에게 가려진 1시간 이내 댓글은 과금되지 않습니다. 0 = 본문만, 비워 두면 전부(기본값). '최대 개수'(게시글 수 제한)와는 별개입니다." }, "dateFrom": { "title": "📅 이 시점 이후 글만 (선택)", "type": "string", "description": "게시판 모드에서 작성 시각 기준으로 사용합니다. 상대 시간 30m(30분), 12h(12시간), 3d(3일), 2w(2주) 또는 날짜 2026-10-01(한국 시간 자정 기준). 비워 두면 거르지 않습니다. 설정하면 오래된 페이지에 닿는 즉시 페이지 넘김을 멈춰 정기 실행 비용을 줄입니다. 목록에서 오늘 글은 분 단위, 이전 글은 날짜 단위로만 표시되므로 날짜 단위 글은 그날 하루 전체로 판단합니다." }, "proxyConfiguration": { "title": "🌐 프록시 (기본: 한국 주거용 프록시)", "type": "object", "description": "더쿠는 Cloudflare 보안 검사로 데이터센터 IP를 차단합니다(403 '보안 검사중'). 기본값인 Apify RESIDENTIAL + 국가 KR 조합에서만 안정적으로 통과하는 것을 확인했으니 바꾸지 않는 것을 권장합니다. 직접 쓰는 프록시가 있을 때만 변경하세요.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }