How to Use Facebook video search in dots
Find public Facebook videos and Reels by keyword, with available titles, descriptions, authors, durations, and thumbnails. Use it to discover product demos, brand mentions, or topic examples across Facebook; text and photo posts are outside its coverage.
Prompts to try with Facebook video search in dots
Copy an example into dots, or ask in your own words.
Every weekday, use Facebook video search for 'LEGO Botanicals' and report video links that have not appeared in earlier reports, with available titles and publisher names.
Every Monday, use Facebook video search for 'Dyson Airwrap' and summarize newly encountered results whose titles or descriptions mention tutorials.
Each morning, use Facebook video search for 'NASA Artemis' and send a linked digest of newly encountered results, including publication dates when supplied.
Every Friday, use Facebook video search for 'GoPro HERO13' and 'GoPro HERO 13', combine duplicate links, and report newly encountered product videos.
Once a week, use Facebook video search for 'Nike running' and report newly encountered videos with a disclosed paid partnership, keeping unknown status separate.
How to set up Facebook video search in dots
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send dots this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Create an API key
In the console, open API keys and create a key for your dot. Copy it.
- Send your dot this message
Your dot reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- Give your dot the key
When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Facebook video search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "scrapecreators", "model": "scrapecreators/facebook-search-videos", "input": { "query": "ai agents" } }'
Then paste one of the prompts above: dots finds Facebook video search on Spiral, shows the price and runs it.
Facebook video search providers and prices
Spiral runs Facebook video search through ScrapeCreators. Open a card for today's price, with every fee included.
What can you do with Facebook video search in dots?
Receive a recurring review queue of newly encountered public Facebook videos mentioning your brand or products. A scheduled agent can repeat chosen searches, compare returned links with previous runs, and summarize the available titles and descriptions.
Find product demonstration examples
Search for a specific product, such as Dyson Airwrap, and build a review list of matching video links, available descriptions, and publishers.
Review competitor messaging
Search LEGO Botanicals and Playmobil separately, then compare the product themes described in returned titles and descriptions.
Monitor public brand mentions
Repeat searches for a brand and its named products. Send newly encountered video links to a review queue for the communications team.
Build an editorial research list
Search topics such as NASA Artemis and collect relevant public video links with their available titles and author information for an editor to inspect.
Find public creator collaboration candidates
Search a product category such as sourdough baking, then shortlist public creator or business publishers whose returned descriptions match a campaign brief.
Review disclosed brand partnerships
Search a brand name and collect results carrying a positive paid-partnership status for manual campaign research. Keep unknown status separate.
More on Facebook video search and dots
Overview
Facebook video search in other agents
Questions about Facebook video search in dots
Can dots use Facebook video search?
Yes. Add Spiral to dots as an MCP server, and dots can find and run Facebook video search like any built-in tool.
How much does Facebook video search cost in dots?
Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.
Do I need a ScrapeCreators account to use Facebook video search in dots?
You need no ScrapeCreators account. dots uses one Spiral API key for every tool, and Spiral runs Facebook video search on its own ScrapeCreators account.
How long does it take to set up Facebook video search in dots?
About two minutes: create an API key, then send your dot this message, then give your dot the key.
Does dots wait while Facebook video search runs?
Facebook video search runs in the background. dots starts the run, checks on it and gives you the json when it's ready.
Which Facebook content does video search cover?
It searches public Facebook videos and Reels by keyword. Text posts and photo posts are outside its coverage.
How fresh are the Facebook search results?
ScrapeCreators says it fetches the latest available information when a search request is made. That describes retrieval freshness, not a guaranteed delay between a video being published and appearing in search.
How do I retrieve more search results?
Continue with the opaque cursor from the previous response and keep the search phrase unchanged. Stop when the cursor is null or the response says there are no more results.
Will every result have a title, date, and duration?
No. The documented examples include null titles, descriptions, publication timestamps, and duration fields, so a result can have a video link without complete descriptive metadata.
Can the results identify sponsored videos?
Paid-partnership status is true when Facebook exposes a paid-partnership label or an explicit branded-content relationship. Unknown status is null, and a missing disclosure does not establish that a video is unsponsored.
Start using Facebook video search in dots
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into dots:
set up https://spiral.ai/SKILL.md


