# Facebook Videos Keyword Search - Views, Dates, No Login (`neverempty/facebook-videos-keyword-search`) Actor

Search public Facebook videos by keyword without login or cookies: title, link, view count, length, date and the posting Page, one row per video, plus reactions, comments and shares where Facebook shows them. Several keywords per run, date ranges, top or latest first. Pay per video only.

- **URL**: https://apify.com/neverempty/facebook-videos-keyword-search.md
- **Developed by:** [NeverEmpty](https://apify.com/neverempty) (community)
- **Categories:** Social media, Marketing, Videos
- **Features:** Limited permissions
- **Stats:** 43 total users, 29 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 1,000 video returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Facebook Videos Keyword Search: Views, Dates, No Login

This Facebook video search scraper finds public videos and reels by keyword, phrase or hashtag, with no login, no cookies and no Facebook account. Each video comes back as one row with its title, link, view count, length, date and the Page that posted it, ready to export as CSV, Excel or JSON or to call through the Apify API.

Where Facebook shows them, rows also give the full view count, the posting time, reactions, comments and shares. Search several terms in one run, sort by top or latest, and set a date range at no extra charge. You pay only per video returned.

### What it does

- **Searches public videos by keyword.** Give it words, phrases or hashtags, including non-English text, such as `home workout`, `#recipe` or `ラーメン`. Each term is searched on its own.
- **Returns the numbers for each video.** Views as a number (`viewCountRounded`, also when Facebook shows them as `1.2K views`), length in seconds, the posting day and the Page or creator with its verified mark.
- **Adds full counts where Facebook gives them.** Rows with `exactCounts: true` carry the full view count (not shortened to `1.2K`), the posting time, reactions, comments and shares.
- **Sorts by top or latest.** `top` reads the videos Facebook ranks first for the term. `latest` reads the newest videos first.
- **Reads deeper, month by month.** After Facebook's own list, the search goes back month by month, which usually finds many more videos than one plain search. With a date range, only the months in it are read, and videos outside the range are not returned or charged.
- **Gives each video once.** A video found for two of your terms is returned once.
- **Charges only for videos that mention your term.** A video is returned when its title, Page name or Page address contains the longest word of your term and at least half of its other words. Videos that do not mention it are left out and not charged.
- **Explains each term's result in a free row.** A free note row tells you when a term reached your limit, had no matching videos, or repeated an earlier term.

### What you can use it for

- Find widely viewed videos on a topic, then sort them by views in your spreadsheet.
- Watch what video creators and Pages post about your brand, product or competitors.
- Track a topic or hashtag daily: set `startDate` and `endDate` both to `yesterday` and run it once a day.
- Collect public videos on a subject for market research, content planning, academic research and AI datasets.

### How to use it

1. Add one or more terms under **Search terms**.
2. Choose **Sort by**, set **Videos per search term**, and add a date range if you want one.
3. Press **Start**, then export the results as CSV, Excel, JSON or through the API.

**Input options**

| Option | What it does |
|---|---|
| `searchTerms` | Words, phrases or hashtags, one per line. Up to 200 per run. Add at least one: an empty field runs a short example search |
| `sortBy` | `top` or `latest`. Top videos is used when empty |
| `maxVideosPerTerm` | Most videos to return for each term, from 1 to 1000. The form starts at 20; if you clear the field, 50 is used |
| `startDate` | Only videos from this date on: a date such as `2026-01-31` (YYYY-MM-DD, from midnight UTC), `today`, `yesterday`, or a period back from now such as `7 days` or `3 months` |
| `endDate` | Only videos up to this date: a date such as `2026-03-31` (that whole day is included), `today`, `yesterday`, or a period back from now such as `1 year` |

Dates and periods are whole UTC days: a period is rounded to the start of its day, so `7 days` starts at midnight UTC seven days ago. The search reads up to 10 years back; a free row says so when your start date is older.

Example input:

```json
{
  "searchTerms": ["home workout", "#recipe"],
  "sortBy": "top",
  "maxVideosPerTerm": 100,
  "startDate": "2026-01-01",
  "endDate": "2026-06-30"
}
```

### What you get

```json
{
  "dataType": "video",
  "searchTerm": "home workout",
  "videoId": "1234567890",
  "url": "https://www.facebook.com/watch/?v=1234567890",
  "title": "15 minute home workout, no equipment",
  "viewCount": 84213,
  "viewCountRounded": 84213,
  "viewCountText": null,
  "durationSeconds": 912,
  "time": "2026-03-14T14:05:00.000Z",
  "timestamp": 1773497100,
  "date": "2026-03-14",
  "dateText": null,
  "reactionCount": 1520,
  "commentCount": 64,
  "shareCount": 31,
  "exactCounts": true,
  "ownerName": "Example Fitness",
  "ownerUrl": "https://www.facebook.com/examplefitness",
  "ownerVerified": false,
  "thumbnailUrl": "https://example.com/thumbnail.jpg",
  "postId": "9876543210"
}
```

A row with `exactCounts: false` gives the views as Facebook shows them (`viewCountText`, for example `80K views`, and `viewCountRounded` 80000) and the day (`date`, from the shown `dateText` such as `Nov 2`), and leaves `viewCount`, `time`, `reactionCount`, `commentCount` and `shareCount` as `null`. A value Facebook does not show is `null`, never a guess. Thumbnail addresses are temporary links from Facebook and stop working after some days, so download what you want to keep.

`viewCount` and `viewCountRounded` are the view counts Facebook shows in its video search results, measured the same way for every video in one run, so you can compare and sort them directly.

Rows with `"dataType": "note"` are free. They appear when a term has no results, reached your limit, repeated an earlier term, was empty, could not be read, or ended early, and when Facebook answered a term only with videos that do not mention it. Each carries a `reason`, the `input` it is about and a `message` that says what happened.

### What does it cost?

You pay per video returned. There is no start fee, and date filters, sorting and the free note rows cost nothing.

| Apify plan | Per 1,000 videos |
|---|---|
| Free | $4.49 |
| Bronze | $3.99 |
| Silver | $3.49 |
| Gold and above | $2.99 |

You pay only the per-video price above. A video is charged once per run, even if it matches two of your terms. Videos outside your date range, videos that do not mention your term, and note rows are not charged. An empty Search terms field runs a short example search, and the videos it returns are charged like any other. Set a maximum total charge on the run, and the Actor stops there and says so in the last row.

### Frequently asked questions

**How do I search Facebook videos by keyword without logging in?**
Type your words under **Search terms** and press **Start**. No account or cookies are needed.

**How many videos do I get for one search term?**
Facebook shows a limited number of videos for one search, so the count depends on how much is posted about the term. The Actor reads Facebook's own list and then goes back month by month. In our tests a plain search gave about 60 to 130 videos, each month read after it gave about 100 to 140 more for a busy term, and a quiet term can give only a few.

**Which rows have exact views, reactions, comments and shares?**
Facebook shows some results as full posts and others as short cards. Full posts carry the exact counts and the posting time (`exactCounts: true`), and how many results come as full posts depends on the search term. Short cards still give the views as shown, the length, the day and the Page.

**How do I get the videos from the previous day each day?**
Set `startDate` and `endDate` both to `yesterday` and schedule the Actor once a day, after midnight UTC. Each run covers one day, so the date ranges of daily runs do not overlap. Videos outside the range are not returned or charged. Short cards are placed by the day Facebook shows (see Good to know).

**Which videos count as mentioning my term?**
A video counts when its title, Page name or Page address contains the longest word of your term and at least half of the other words, each at the start of a word, so `review` does not match inside `preview`. A word of 6 letters or more also matches without its last 2 letters, so `recipes` finds `recipe`. Small words such as `the`, `in` or `how` are not needed, and the words written together count too: `#dogtraining` counts for `dog training`. Japanese, Chinese, Korean and Thai words are found anywhere in the text. The video's link is not read.

**Can I search hashtags or non-English words?**
Yes. Hashtags such as `#recipe` and text in Japanese or Spanish work the same way as English words.

**Can I search videos from a past month?**
Yes. Set `startDate` and `endDate`, for example `2025-03-01` and `2025-03-31`.

**Can I use it from my own code or an AI agent?**
Yes. Start it through the Apify API or the Apify MCP server, and read the rows as JSON.

### Good to know

- **Personal data is your responsibility.** Videos can name or show people. Emails and phone numbers in titles are masked, and profile and video addresses that carry a personal number are left out (the video link then becomes `watch/?v=` with the video ID), but names and other details stay. The usual Facebook rules and privacy laws such as GDPR apply to how you use the data.
- The Actor returns what Facebook shows a visitor who is not logged in. Videos shared only with friends or in private groups are not part of the search.
- It gives the video details and counts, not the video file or the comment text.
- Search results depend on Facebook's own ranking, so the same term can give a somewhat different set of videos on another day.
- If Facebook does not return a term's results, the Actor tries again. A term it still could not read gets a free `unreadable` or `incomplete` row. If most terms cannot be read, the run stops and the last row lists the terms not finished.
- A video that Facebook shows only as a short card is placed by the day the card shows. That day follows Facebook's own clock (US Pacific time), so for a video posted between midnight and about 8:00 UTC it is the day before the UTC day. Times such as `5 hours ago` are read on the same clock.
- A term ends after three months in a row gave no new video, and a free row says so.
- If 25 search terms in a row return no video, the run stops to save cost, and a free row lists the terms not searched.
- If a run reaches its time limit or maximum charge, the last row lists the terms not finished (`notFinishedTerms`). To continue, resurrect (restart) the same run from the Apify Console; videos it already returned are not charged again. A new run starts over and charges for each video it returns.

### Thanks for using this Actor

We build these tools for people who run them daily, and we improve them from what users tell us.

- **Missing a field, or need another filter?** Tell us in the **Issues** tab. If the data is there, we add it.
- **Found a bug or a wrong value?** Post the run ID in the **Issues** tab. Wrong data is the thing we fix first.

If this Actor saved you time, a short review helps other people find it.

# Actor input Schema

## `searchTerms` (type: `array`):

Add at least one word, phrase or hashtag, one per line, for example home workout, #recipe or ラーメン. Each term is searched on its own. Up to 200 terms per run.

## `sortBy` (type: `string`):

"top" reads the videos Facebook ranks first for the term. "latest" reads the newest videos first. Older months are then read from the newest one back. Top videos is used when empty.

## `maxVideosPerTerm` (type: `integer`):

The most videos to return for each search term, from 1 to 1000. The form starts at 20 to keep a first test small; if you clear the field, 50 is used. After Facebook's own list, the search goes back month by month to reach more videos.

## `startDate` (type: `string`):

Only videos posted on or after this day. Examples: 2026-01-31, yesterday, "7 days" (seven days back from now). Days are read as UTC. The search reads up to 10 years back. Videos left out are not charged. Leave empty for no start limit.

## `endDate` (type: `string`):

Only videos posted on or before this day. Examples: 2026-03-31 (that whole day is included), yesterday, "1 year" (one year back from now). For a daily run, set both dates to yesterday. Videos left out are not charged. Leave empty for no end limit.

## Actor input object example

```json
{
  "searchTerms": [
    "home workout"
  ],
  "maxVideosPerTerm": 20
}
```

# Actor output Schema

## `results` (type: `string`):

One row per public Facebook video found for your search terms: title, link, views, length, date, reactions, comments, shares and the posting Page. Rows with dataType "note" are free and say why something was not returned.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "home workout"
    ],
    "maxVideosPerTerm": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("neverempty/facebook-videos-keyword-search").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["home workout"],
    "maxVideosPerTerm": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("neverempty/facebook-videos-keyword-search").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "home workout"
  ],
  "maxVideosPerTerm": 20
}' |
apify call neverempty/facebook-videos-keyword-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neverempty/facebook-videos-keyword-search"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/GVIuEHCm6ARLbRy5P/builds/UCbhuvY4p8jjKaqW9/openapi.json
