Skip to main content
POST
Rank cited YouTube videos, for one channel or across all of them. Calculated from Profound’s citation data, not YouTube analytics.
  • Source types: video, short, channel, playlist, or other. other is available with unattributed or all; with the default attributed mode, requests containing other are rejected. Omit source_types to return video and short with the default attributed mode; unattributed and all widen the default to all five source types. Provide a non-empty list; duplicate values are de-duplicated.
  • Attribution: attributed (the default), unattributed, or all. An unattributed row has no channel: source_type is other for a search or feed URL that names no source, and any other type is a source we have no channel for.
  • Grouping and time series: Not supported. /videos accepts no group_by or interval; unknown fields are rejected.
  • Pagination: limit defaults to 10 and accepts 1–50. Pass the opaque info.next_cursor back as the request cursor to get the next page; info echoes your cursor on pages after the first. The response info echoes category_id, the effective limit, and attribution.
  • Filters: Prompt-level fields are model, topic, region, prompt, persona, tag, and analysis_type. The channel filter accepts is, in, contains, not_contains, contains_case_insensitive, and not_contains_case_insensitive: is/in select exact handles, while the other operators match channel titles or handles. domain and page are rejected. A channel leaf cannot share an or or not with a prompt-level leaf; put separate layers in and clauses.
The v2 reports share a request shape and filter tree. See Filtering & concepts for filter operators, date ranges, pagination, and filter depth. Grouping and time series guidance does not apply to this endpoint.

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Cited videos, optionally narrowed to specific channels.

​
category_id
string<uuid>
required
​
start_date
string
required

YYYY-MM-DD, ET, inclusive

​
end_date
string
required

YYYY-MM-DD, ET, inclusive

​
filter
FilterNode · object | null

Advanced filter tree. Prompt-level dimensions are model, topic, region, prompt, persona, tag, analysis_type. channel covers both channel cases: in with a list of handles selects exactly those channels, resolving each handle to its channel so a renamed channel is never returned in pieces; contains matches a channel's title or handle by name. Combine with and/or/not up to 3 deep. An exact channel selection must be its own and clause, and a channel leaf cannot share an or or not with a prompt-level leaf, because those compile at different stages of the query. domain and page are rejected rather than approximated: every row here is one domain, and page is not a video id.

​
limit
integer | null

Page size; default 10, max 50.

Required range: 0 < x <= 50
​
cursor
string | null
​
source_types
enum<string>[] | null

Limit results to YouTube source types: video, short, channel, playlist, or other. Omit to include video and short with the default attribution='attributed'; unattributed and all widen the default to all five source types. Requests containing other with attribution='attributed' are rejected.

Available options:
video,
short,
channel,
playlist,
other
​
attribution
enum<string>
default:attributed

Choose attributed citations, unattributed citations, or all citations. An unattributed row has no channel: source_type is other for a search or feed URL that names no source, and any other type is a source we have no channel for.

Available options:
attributed,
unattributed,
all

Response

Successful Response

​
info
YoutubeVideosInfo · object
required

Video report metadata, including effective paging and attribution settings.

​
data
YoutubeVideoRow · object[]
required