{"uid":"cap_Nr3z1LrVKZ7WSC2q_ItM8","slug":"agent402-video-search-6e561f11","name":"Agent402 Video Search","description":"Live video search: ranked video results (title, video page URL, description, duration, creator, publisher, thumbnail, age) from an independent search index as clean JSON. Completes the web/news/images search family. Same freshness filter (pd/pw/pm/py); strict safe-search is on by default.","url":"https://agent402.tools/api/search-videos","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search query (max 400 chars)"},"count":{"type":"number","description":"Results to return, 1-50 (default 10)"},"country":{"type":"string","description":"Optional 2-letter country code (default US)"},"freshness":{"type":"string","description":"Optional: pd, pw, pm, or py (past day/week/month/year)"},"safesearch":{"type":"string","description":"Optional: 'strict' (default) or 'off'"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","count","results"],"properties":{"count":{"type":"integer"},"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"age":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"creator":{"type":"string"},"duration":{"type":"string"},"publisher":{"type":"string"},"thumbnail":{"type":"string"},"description":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"count":2,"query":"agent payments","results":[{"age":"March 23, 2026","url":"https://www.youtube.com/watch?v=example","title":"The future of agentic payments","creator":"Example Channel","duration":"14:58","publisher":"YouTube","thumbnail":"https://imgs.search.brave.com/...","description":"How payment infrastructure for AI agents is built…"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rxAUn-6AYVyoP_zqZPUlh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked video search results (title, URL, description, duration, creator, publisher, thumbnail, age) as clean JSON from an independent search index","exampleAgentPrompt":"Search for videos about 'machine learning for beginners' from the past week, return 15 results for the US, and give me the title, duration, creator, and thumbnail for each.","exampleUseCases":null,"resultDescription":"A JSON array of ranked video results, each containing: title, video page URL, description, duration, creator name, publisher, thumbnail image URL, and age/publish date of the video. Results are drawn from an independent search index and can be filtered by freshness and country.","failureModes":["Missing required 'q' parameter returns a 400 error","Query exceeding 400 characters may be rejected or truncated","Invalid country code returns an error or falls back to US defaults","Invalid freshness value (not pd/pw/pm/py) may be ignored or cause an error","count outside 1-50 range may be clamped or rejected","No results found returns an empty array","Payment not attached or insufficient USDC returns a 402 error"],"whenToPreferThis":"Use this endpoint when you need structured video search results (with metadata like duration, creator, and thumbnail) from an independent index rather than a platform-specific API. Ideal for completing a full web+news+images+video search pipeline, or when you need freshness-filtered video results as clean JSON without scraping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:17:00.462Z","isFirstParty":false}