{"uid":"cap_5AS7vHaC0x6TrnaHojGSe","slug":"api-direct-facebook-video-search-262e6634","name":"API Direct – Facebook Video Search","description":"Search for Facebook videos by keyword.","url":"https://x402.apidirect.io/v1/facebook/videos?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"pages":{"type":"integer","default":1,"maximum":15,"minimum":1,"description":"Number of pages to fetch and merge into one response (1-15). Billed per page."},"query":{"type":"string","maxLength":500,"description":"Search query (max 500 characters)"},"sort_by":{"enum":["most_recent","relevance"],"type":"string","default":"relevance","description":"Sort order for results. most_recent returns the newest videos first; relevance is the default."},"end_date":{"type":"string","description":"Filter videos until this date (YYYY-MM-DD)"},"start_date":{"type":"string","description":"Filter videos from this date (YYYY-MM-DD)"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each video. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any video"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VL2Hac7yQoII6zzNY7idX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Facebook videos by keyword with optional date filtering, sort order, and AI-powered sentiment/emotion analysis.","exampleAgentPrompt":"Search Facebook videos for 'electric vehicles' posted between 2024-01-01 and 2024-06-30, sorted by most recent, and include AI sentiment analysis on the results — fetch 2 pages.","exampleUseCases":[{"title":"Brand sentiment monitoring on Facebook","prompt":"Search Facebook videos mentioning 'Nike running shoes' from the last 3 months, sort by relevance, and turn on sentiment analysis so I can see how people are emotionally reacting to the brand."},{"title":"Breaking news video discovery","prompt":"Find the most recent Facebook videos about the 2024 US election results — sort by most recent and pull 3 pages of results so I get broad coverage."},{"title":"Competitor product launch research","prompt":"Search Facebook videos about 'Apple Vision Pro' posted between 2024-01-01 and 2024-03-31, sorted by relevance, with sentiment analysis enabled — I want to understand the emotional tone of reactions."}],"resultDescription":"Returns a merged list of Facebook video results across the requested number of pages, including video metadata (title, URL, view counts, publish date, etc.). When get_sentiment is true, each video also includes a sentiment object with emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0-100), a dominant_emotion field, emotional_intensity (0-10), and polarity (positive, negative, or neutral).","failureModes":["Missing required 'query' parameter returns a validation error","Date format errors if start_date or end_date are not in YYYY-MM-DD format","Pages exceeding maximum of 15 return a validation error","Facebook-side rate limiting or access restrictions may return partial or empty results","Query exceeding 500 characters is rejected","No matching videos returns an empty result set rather than an error"],"whenToPreferThis":"Use this endpoint when you need to search and retrieve Facebook video content by keyword, optionally within a date range and with AI-powered emotional sentiment analysis. Prefer it over general web search when you specifically need Facebook video data. It is especially useful for brand monitoring, content research, news event tracking, or competitive analysis on Facebook's video platform. If you also need sentiment breakdowns beyond simple polarity, the built-in emotion scoring (joy, anger, fear, etc.) makes this a strong choice over plain search endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:01.357Z","isFirstParty":false,"canonicalSlug":"api-direct-facebook-video-search-262e6634"}