
Introducing Search
Give your agent web search in one call: each result comes with the passages of its page that answer the query, for 0.5 credits a search.

Search YouTube, Instagram and Threads and read videos, posts, comments, profiles and YouTube captions as JSON from any API key, for 0.5 credits a completed request.
platform youtube: search results, the newest uploads for a query, a video’s watch page, comments with their replies, a channel, a channel’s videos, Shorts or live streams, and captions.platform instagram: posts and reels for a keyword, a public profile with its 12 most recent posts, one post or reel, and its comments.platform threads: posts for a keyword, a public profile with its recent posts, one post, and its replies.viewCount, likeCount, commentCount and followerCount, with publishedAt times, so you compare posts without parsing text like 62K.Send taskType SOCIAL to POST /v1/async/task with a platform and an action. search, the default, takes query. The other actions take videoId, channel, username or postUrl, and you can paste the page URL there.
Social reads public pages. On Instagram that is the 12 most recent posts of a profile and about a dozen comments of a post, and on Threads about 10 replies a post. A page that does not exist or that needs a signed-in viewer ends the task with PAGE_UNAVAILABLE.
A YouTube video search ordered by relevance returns nextPageToken for the next page. transcript returns the caption text and timed segments in the languages you list, and translateTo asks YouTube to translate them. The read_social tool on the querying.ai MCP server runs the same reads from Claude Code, Codex, Cursor and other MCP clients.
Send the request with your API key in the Authorization header.
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
}
}'taskTypestringRequiredCHATGPT or GOOGLE.payload.platformstringRequiredyoutube, instagram or threads.payload.actionstringsearch, video, comments or transcript. Default search. Each platform lists its actions in the docs.payload.querystringsearch and recent, written the way a viewer types it into the platform’s search box.payload.limitintegerwebhook.urlstringA finished task looks like this, trimmed for length.
{
"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, then COMPLETED with the answer or FAILED with error.credits.creditsChargedintegerresponse.returnedCountintegerproducts.response.videosarrayposition, videoId, url, title, the channel, publishedAt, durationSeconds, viewCount and likeCount.The request returns the task right away with status QUEUED. Poll GET /v1/async/task/{id} until status is COMPLETED or FAILED, or add webhook.url and the finished task arrives at your server with the same task, credits and response. Results stay available for 24 hours after a task finishes.
curl https://api.querying.ai/v1/async/task/$TASK_ID \
-H "Authorization: Bearer $QUERYING_API_KEY"Each completed request uses 0.5 credits, on every platform and every action. Only completed requests are charged. Plans and credits: https://querying.ai/pricing

Give your agent web search in one call: each result comes with the passages of its page that answer the query, for 0.5 credits a search.
Follow the answering model, every response field and each day’s changes across ChatGPT, Gemini, Google AI Overviews and Google AI Mode, on one public page and a free API.
Get new product updates in your inbox.