Skip to main content
POST
YouTube Rank Tracker API

YouTube Rank Tracker

Rank tracking for YouTube. Pick a country and a language and see the videos YouTube lists for a query, in order, with each video’s title, channel, view count, length, thumbnail and publish date. Watch where your videos land for target keywords, see which channels own a topic in each market, and pick keywords where the top results are thin.
Provide a search query in query. The defaults are United States (2840) and English (en). results_limit defaults to 20 and accepts integers from 1 to 200. Rows are videos only, in ranking order. Each video costs 0.5 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a search query in query. Each row is one video in YouTube's search ranking for the chosen country and language, with its channel, views, duration and publish time. results_limit defaults to 20 and accepts integers from 1 to 200.

query
string
required

Search query, as typed into the search box.

Minimum string length: 1
callback_url
string<uri>
language
string
Minimum string length: 1
language_code
string
Required string length: 2 - 10
location_code
integer

Search market location code.

Required range: x >= 1
location_name
string

Search market location name.

Minimum string length: 1
results_limit
integer
default:20
Required range: 1 <= x <= 200

Response

Task accepted

code
integer
data
object