Spiral gives your agent every tool with one account. Browse the tools →

Grok · Social Media

How to Use Facebook video search in Grok

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 Grok

Copy an example into Grok, or ask in your own words.

Use Facebook video search for 'LEGO Botanicals' and give me a linked shortlist of results whose titles or descriptions discuss building the sets.

Facebook video searchGrok
Try asking
  • Use Facebook video search for 'Dyson Airwrap' and group the returned titles and descriptions into tutorials, reviews, and unclear matches.

  • Use Facebook video search for 'NASA Artemis' and list the returned video links, publisher names, and publication dates where available.

  • Use Facebook video search for 'GoPro HERO13' and compare the topics mentioned in the returned descriptions. Include the source video links.

  • Use Facebook video search for 'Nike running' and show results with a disclosed paid partnership separately from results with unknown partnership status.

How to set up Facebook video search in Grok

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

Use the Grok connector

  1. Add a custom connector

    In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

    https://api.spiral.ai/mcp
  2. Sign in to Spiral and approve

    Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

  3. Check that it is connected

    Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

Use the Spiral skill

  1. Send Grok 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 the Spiral CLI

  1. 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

  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.

    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: Grok 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.

ScrapeCreatorsSocial Media
Facebook · Search Videos
scrapecreators/facebook-search-videos

What can you do with Facebook video search in Grok?

Create a short reading list of public Facebook videos about a product, brand, or news topic. A chat app can organize returned titles, descriptions, and publisher names into a comparison with links for you to inspect.

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.

Questions about Facebook video search in Grok

Can Grok use Facebook video search?

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

How much does Facebook video search cost in Grok?

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

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

No. Spiral runs Facebook video search on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Facebook video search in Grok?

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

Does Grok wait while Facebook video search runs?

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

Get started

Start using Facebook video search in Grok

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Grok:

Set up Grok

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options