본문으로 건너뛰기
체인지로그새 기능

Social: YouTube, Instagram, Threads를 API로 읽어요

Social
POST /v1/async/task로 보낸 SOCIAL 요청(YouTube 검색 wireless earbuds review)과 응답의 첫 영상: 채널, 조회수 62,618, 좋아요 957

YouTube, Instagram, Threads를 검색하고 영상, 게시물, 댓글, 프로필, YouTube 자막을 JSON으로 받아요. 모든 API 키에서 쓸 수 있고, 완료된 요청 하나에 0.5크레딧이에요.

받는 결과

  • platform youtube: 검색 결과, 검색어의 최신 업로드, 영상 시청 페이지, 댓글과 답글, 채널, 채널의 영상과 Shorts와 라이브, 자막을 받습니다.
  • platform instagram: 키워드의 게시물과 릴스, 공개 프로필과 최근 게시물 12개, 게시물이나 릴스 하나, 그 댓글을 받습니다.
  • platform threads: 키워드의 게시물, 공개 프로필과 최근 게시물, 게시물 하나, 그 답글을 받습니다.
  • viewCount, likeCount, commentCount, followerCount 같은 수치는 숫자로, publishedAt 시각과 함께 옵니다. 62K 같은 글자를 따로 풀지 않고 바로 비교합니다.

동작 방식

POST /v1/async/task에 taskType SOCIAL과 platform, action을 보냅니다. 기본값인 search는 query를 받습니다. 다른 action은 videoId, channel, username, postUrl 중 하나를 받고, 여기에 페이지 URL을 그대로 넣어도 됩니다.

Social은 공개 페이지를 읽습니다. Instagram은 프로필의 최근 게시물 12개와 게시물의 댓글 약 12개, Threads는 게시물마다 답글 약 10개입니다. 없는 페이지나 로그인해야 보이는 페이지는 PAGE_UNAVAILABLE로 태스크가 끝납니다.

relevance 순서의 YouTube 영상 검색은 다음 페이지용 nextPageToken을 돌려줍니다. transcript는 지정한 언어의 자막 text와 시간이 붙은 segments를 돌려주고, translateTo를 넣으면 YouTube가 번역합니다. querying.ai MCP 서버의 read_social 도구로 Claude Code, Codex, Cursor 같은 MCP 클라이언트에서도 같은 요청을 실행합니다.

이렇게 활용하세요

  • 우리 브랜드 영상과 경쟁사 영상의 조회수, 좋아요, 댓글을 날마다 추적하세요.
  • YouTube, Instagram, Threads에서 출시 소식 아래 달린 댓글과 답글을 읽고, 사람들이 묻는 것을 정리하세요.
  • 리뷰 영상의 자막을 시간과 함께 모델에 넘기고, 우리 제품이 나오는 대목을 찾으세요.
  • 같은 검색어에서 YouTube와 Threads의 크리에이터 말과 ChatGPT, Google AI Mode 답변을 나란히 비교하세요.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "SOCIAL",
    "payload": {
      "platform": "youtube",
      "action": "search",
      "query": "wireless earbuds review",
      "limit": 10
    }
  }'

요청 필드

taskTypestring필수
실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.
payload.platformstring필수
읽을 플랫폼입니다. youtube, instagram, threads 중 하나를 넣습니다.
payload.actionstring
읽을 대상입니다. search, video, comments, transcript 같은 값을 넣습니다. 기본값 search. 플랫폼별 값은 문서에 있습니다.
payload.querystring
search와 recent에 쓰는 검색어입니다. 플랫폼 검색창에 입력하듯 씁니다.
payload.limitinteger
돌려받을 결과 수입니다. YouTube 검색은 1~50, 기본값 10.
webhook.urlstring
서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.

응답

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SOCIAL",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 0.5, "creditsCharged": 0.5 },
  "response": {
    "platform": "youtube",
    "action": "search",
    "query": "wireless earbuds review",
    "order": "relevance",
    "returnedCount": 10,
    "videos": [
      {
        "position": 1,
        "videoId": "YdJh6QdOGME",
        "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
        "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
        "channelTitle": "Mike O'Brien",
        "channelHandle": "@MikeOBrienMedia",
        "publishedAt": "2026-11-17T15:39:37Z",
        "durationSeconds": 995,
        "viewCount": 62618,
        "likeCount": 957
      },
      "…"
    ],
    "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
  }
}
task.statusstring
QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
credits.creditsChargedinteger
끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.returnedCountinteger
products에 담긴 상품 수입니다.
response.videosarray
YouTube 순서대로 담긴 영상입니다. position, videoId, url, title, 채널, publishedAt, durationSeconds, viewCount, likeCount가 담깁니다.

결과 받기

요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

요금

완료된 요청 하나에 0.5크레딧이며, 플랫폼과 action에 상관없이 같습니다. 완료된 요청만 차감됩니다. 플랜과 크레딧: https://querying.ai/pricing

다른 업데이트

새 소식을 받아보세요

제품 업데이트를 이메일로 보내드립니다.

RSS 구독