[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [Facebook video search](https://spiral.ai/integrations/instinct/facebook-video-search)

# How to Use Facebook video search in Instinct

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.

|  |  |
| --- | --- |
| Model | Facebook video search |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Facebook video search in Instinct

- 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 Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **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

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Facebook video search**: One request; the result comes back by polling or a webhook.

```bash
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: Instinct finds Facebook video search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## Facebook video search tools and prices

- [Facebook · Search Videos](https://spiral.ai/tools/scrapecreators/scrapecreators/facebook-search-videos) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | The opaque cursor returned by the previous response. Keep the query unchanged when paginating. Stop when cursor is null or has_more is false. |

## What can you do with Facebook video search in Instinct?

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.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## Facebook video search in other agents

- [Amp](https://spiral.ai/integrations/amp/facebook-video-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/facebook-video-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/facebook-video-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/facebook-video-search)
- [Cline](https://spiral.ai/integrations/cline/facebook-video-search)
- [Codex](https://spiral.ai/integrations/codex/facebook-video-search)
- [Cursor](https://spiral.ai/integrations/cursor/facebook-video-search)
- [Devin](https://spiral.ai/integrations/devin/facebook-video-search)
- [dots](https://spiral.ai/integrations/dots/facebook-video-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/facebook-video-search)
- [Gemini](https://spiral.ai/integrations/gemini/facebook-video-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/facebook-video-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/facebook-video-search)
- [goose](https://spiral.ai/integrations/goose/facebook-video-search)
- [Grok](https://spiral.ai/integrations/grok/facebook-video-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/facebook-video-search)
- [Hermes](https://spiral.ai/integrations/hermes/facebook-video-search)
- [Manus](https://spiral.ai/integrations/manus/facebook-video-search)
- [Muse](https://spiral.ai/integrations/muse/facebook-video-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/facebook-video-search)
- [n8n](https://spiral.ai/integrations/n8n/facebook-video-search)
- [Notion](https://spiral.ai/integrations/notion/facebook-video-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/facebook-video-search)
- [opencode](https://spiral.ai/integrations/opencode/facebook-video-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/facebook-video-search)
- [Raycast](https://spiral.ai/integrations/raycast/facebook-video-search)
- [VS Code](https://spiral.ai/integrations/vscode/facebook-video-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/facebook-video-search)
- [Zapier](https://spiral.ai/integrations/zapier/facebook-video-search)

## More Instinct guides

- [Facebook video and post details](https://spiral.ai/integrations/instinct/facebook-video-and-post-details)
- [Facebook video transcript](https://spiral.ai/integrations/instinct/facebook-video-transcript)
- [Facebook post comments](https://spiral.ai/integrations/instinct/facebook-post-comments)
- [Google Ad Library Company Ads](https://spiral.ai/integrations/instinct/google-ad-library-company-ads)
- [Facebook page reels](https://spiral.ai/integrations/instinct/facebook-page-reels)
- [Google Ads advertiser search](https://spiral.ai/integrations/instinct/google-ads-advertiser-search)

## Questions about Facebook video search in Instinct

**Can Instinct use Facebook video search?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run Facebook video search like any built-in tool.

**How much does Facebook video search cost in Instinct?**

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 Instinct plan is separate.

**Do I need a ScrapeCreators account to use Facebook video search in Instinct?**

You need no ScrapeCreators account. Instinct 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 Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while Facebook video search runs?**

Facebook video search runs in the background. Instinct 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.

