POST
/
search
/
video
Search for videos
curl --request POST \
  --url https://api.vidnavigator.com/v1/search/video \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "query": "What are the best practices for React development?",
  "use_enhanced_search": true,
  "start_year": 2020,
  "end_year": 2024,
  "focus": "relevance",
  "duration": 600
}'
{
  "status": "success",
  "data": {
    "results": [
      {
        "title": "<string>",
        "url": "<string>",
        "description": "<string>",
        "thumbnail": "<string>",
        "channel": "<string>",
        "published_date": "<string>",
        "duration": 123,
        "views": 123,
        "likes": 123,
        "relevance_score": 123,
        "transcript_summary": "<string>",
        "people": [
          {
            "name": "<string>",
            "context": "<string>"
          }
        ],
        "places": [
          {
            "name": "<string>",
            "context": "<string>"
          }
        ],
        "key_subjects": [
          {
            "name": "<string>",
            "description": "<string>"
          }
        ],
        "timestamp": 123,
        "relevant_text": "<string>",
        "query_relevance": "<string>"
      }
    ],
    "query": "<string>",
    "total_found": 123,
    "explanation": "<string>"
  }
}
Search for videos using AI-powered semantic search with intelligent ranking and filtering.

Overview

Find the most relevant videos using natural language queries. Our AI analyzes video content, transcripts, and metadata to deliver precisely ranked results.

Search Process

  1. Enhanced Query Processing: AI expands and optimizes your search query
  2. Content Analysis: Deep analysis of video transcripts and metadata
  3. Intelligent Ranking: Results ranked by relevance, not just keyword matching
  4. Rich Results: Detailed video information with explanations

Search Options

Enhanced Search

AI-powered query expansion and optimization (recommended)

Year Filtering

Filter results by publication date range

Duration Filtering

Limit results by maximum video duration

Focus Types

Prioritize relevance, popularity, or brevity

Example Usage

curl -X POST "https://api.vidnavigator.com/v1/search/video" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What are the best practices for React development?",
    "use_enhanced_search": true,
    "start_year": 2020,
    "end_year": 2024,
    "focus": "relevance",
    "duration": 1800
  }'

Response Example

{
  "status": "success",
  "data": {
    "results": [
      {
        "title": "React Best Practices 2024: Clean Code & Performance",
        "description": "Complete guide to writing maintainable React code...",
        "url": "https://youtube.com/watch?v=example123",
        "thumbnail": "https://img.youtube.com/vi/example123/maxresdefault.jpg",
        "channel": "React Mastery",
        "duration": "15:30",
        "views": 125000,
        "published_date": "2024-01-15",
        "relevance_score": 0.95,
        "explanation": "This video directly addresses React best practices with focus on clean code and performance optimization.",
        "key_topics": ["React hooks", "Performance optimization", "Code organization"]
      }
    ],
    "query": "What are the best practices for React development?",
    "total_found": 1,
    "explanation": "Found videos discussing React development best practices, focusing on recent content and high relevance."
  }
}

Use Cases

Research & Learning

Find educational content on specific topics or technologies

Content Curation

Build curated lists of videos for courses or documentation

Competitive Analysis

Analyze what content exists in your industry or niche

Trend Discovery

Identify trending topics and popular content creators

Authorizations

X-API-Key
string
header
required

API key authentication. Include your VidNavigator API key in the X-API-Key header.

Body

application/json

Response

200
application/json

Search completed successfully

The response is of type object.