NAnationgraph
YouTube

Search Youtube

Search YouTube caption chunks.

Institution linkage is dual-route — chunks are matched if EITHER the video's channel is mapped to the institution (via youtube_links) OR the video itself carries a per-video tag (raw.video_institution_unique_id). Results from both routes are unioned and deduped, preferring the per-video tag when both routes match the same chunk.

The query field uses websearch_to_tsquery('english', ...) — websearch syntax (quoted phrases, OR, leading - to exclude). For tight phrase matching, quote the phrase. Cover-density ranking (ts_rank_cd) already favors chunks where query terms appear close together.

At least one of institution_ids or query is required.

post/api/internal/youtube/search

Request

Request body

querystring nullable
institution_idsstring[] nullable
statesstring[] nullable
source_tablesstring[] nullable
date_afterstring date nullable
date_beforestring date nullable
group_by_documentboolean
offsetinteger
limitinteger

Response

Successful Response

totalinteger required
offsetinteger required
limitinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.