
Search를 소개해요
에이전트에 웹 검색을 한 번의 호출로 붙여요. 결과마다 검색어에 답하는 페이지 단락이 함께 오고, 검색 한 번에 0.5크레딧이에요.

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 클라이언트에서도 같은 요청을 실행합니다.
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.actionstringsearch, video, comments, transcript 같은 값을 넣습니다. 기본값 search. 플랫폼별 값은 문서에 있습니다.payload.querystringsearch와 recent에 쓰는 검색어입니다. 플랫폼 검색창에 입력하듯 씁니다.payload.limitintegerwebhook.urlstring완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.
{
"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.statusstringQUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.credits.creditsChargedintegerresponse.returnedCountintegerproducts에 담긴 상품 수입니다.response.videosarrayposition, 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

에이전트에 웹 검색을 한 번의 호출로 붙여요. 결과마다 검색어에 답하는 페이지 단락이 함께 오고, 검색 한 번에 0.5크레딧이에요.
ChatGPT, Gemini, Google AI Overviews, Google AI Mode에서 답한 모델과 응답의 모든 필드, 날짜별 변화를 공개 페이지와 무료 API로 확인하세요.
제품 업데이트를 이메일로 보내드립니다.