# Forums and Blogs: online discussions scraper (`monkey.d.scraping/forum-search-engine`) Actor

Find mentions of your brand, competitors, and products across forums and online communities. Enable Include blogs to find matching blog posts too. Export matching excerpts and links to the original discussions. Explore customer questions and follow linked replies on supported communities.

- **URL**: https://apify.com/monkey.d.scraping/forum-search-engine.md
- **Developed by:** [Monkey D. Scraping](https://apify.com/monkey.d.scraping) (community)
- **Categories:** Social media, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 forum mentions

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

## Brand Mentions Across Forums and Blogs

Find mentions of your brand, competitors, and products across forums and online communities. Enable Include blogs to find matching blog posts too. Export matching excerpts and links to the original discussions. Explore customer questions and follow linked replies on supported communities.

![Example runs for CeraVe and Cetaphil (60 mentions) and Zyrtec (150 mentions, 54 linked replies)](https://gist.githubusercontent.com/Odamaclaymore94/2e13839a8fd4eb3ee54d8ba78f927cf9/raw/43557fbc52b057e6c1609876516685cf87af46f9/brand-mentions.svg)

### Start with a use case

| Task | Example input | What you get |
|---|---|---|
| [Find Brand and Competitor Mentions](https://apify.com/monkey.d.scraping/forum-search-engine/examples/find-brand-and-competitor-mentions) | CeraVe and Cetaphil | Matching passages grouped by keyword in the digest, plus individual rows with community names and links. |
| [Research Customer Questions About a Product](https://apify.com/monkey.d.scraping/forum-search-engine/examples/research-customer-questions-about-a-product) | Zyrtec with reply context enabled | Product discussions to review for customer questions. Supported Mumsnet and OzBargain threads include linked messages with both texts and permalinks. |

[中文说明](#中文说明) · [Pricing](#pricing) · [For AI agents](#for-ai-agents) · [Input](#input) · [Output](#output) · [FAQ](#faq)

### What you can do with it

#### Monitor brand mentions in forums

Track what people say about your brand, product or competitors outside the big social networks. Run it daily with **Time period → Past day** and compare thread IDs between exports.

#### Search discussion boards for a topic

Searching dozens of forums one by one is slow. Type a topic once ("ozempic side effects", "toyota rav4 hybrid problems", "best stroller for travel") and get the threads from every forum together, with a forum label and dates for filtering.

#### Market and product research

Find real complaints, questions, comparisons and recommendations written by customers, in their own words and languages: Italian ForumFree boards, French Forumactif communities, German motor-talk, Chinese Zhihu, Turkish Şikayetvar, Vietnamese VOZ.

#### Find conversations to join

Spot fresh threads where people ask for a product like yours, then reply where it helps.

#### Feed AI analysis

Every run also saves a Markdown digest grouped by keyword, ready to paste into ChatGPT, Claude or your own LLM pipeline for sentiment and topic analysis.

### Forums covered

| Region | Forums and communities |
|---|---|
| English-speaking and global | Reddit, Quora, Stack Exchange, Stack Overflow, Hacker News, Mumsnet, MoneySavingExpert, City-Data, TripAdvisor forums, FlyerTalk, Bogleheads, MacRumors, XDA, Tom's Hardware, Steam Community, Head-Fi, Slickdeals, Patient, Spiceworks, Houzz, Digital Spy, PistonHeads, Boards.ie, OzBargain, Whirlpool, Team-BHP, BabyCenter, What to Expect, Linus Tech Tips, ResetEra, Straight Dope, Motley Fool, Rick Steves, Apple, Samsung and Spotify communities, Blizzard, CHOICE, dev.to, Tildes, Lemmy, MetaFilter, NeoGAF, AnandTech, RedFlagDeals, HotUKDeals, Groups.io, ProBoards, Tapatalk, Forumotion, Website Toolbox, Nairaland |
| Europe | ForumFree, ForumCommunity, Forumattivo, Blogfree, HWUpgrade, alfemminile (Italy) · Forumactif, Forumgratuit, Doctissimo, jeuxvideo.com, CommentÇaMarche, Caradisiac, Dealabs, Hardware.fr, MacGeneration (France) · Forocoches, Mediavida, Burbuja, Rankia, mforos, Foroactivo, Elotrolado (Spain) · Zwame (Portugal) · gutefrage, motor-talk, ComputerBase, Hardwareluxx, android-hilfe, urbia, mydealz, kaffee-netz, xobor (Germany) · Tweakers, Viva, FOK (Netherlands) · Flashback, Familjeliv, SweClockers (Sweden) · Suomi24, Ylilauta (Finland) · Kvinneguiden (Norway) · Wykop, Elektroda (Poland) · Prohardver (Hungary) · Insomnia (Greece) · Forum.hr (Croatia) |
| Asia | Zhihu, Douban, NGA, Chiphell, V2EX (China) · PTT, Mobile01, Dcard (Taiwan) · LIHKG (Hong Kong) · Yahoo Chiebukuro, Kakaku, 5ch (Japan) · DCInside, Clien, Ruliweb, Ppomppu, FM Korea, theqoo (Korea) · Pantip (Thailand) · Kaskus (Indonesia) · VOZ, Tinhte (Vietnam) · Lowyat (Malaysia) · HardwareZone (Singapore) |
| Russia | Habr, Pikabu, 4PDA, iXBT, DTF, mybb.ru, borda |
| Latin America | Forumeiros, Reclame Aqui (Brazil) |
| Middle East & Africa | Ekşi Sözlük, Şikayetvar, DonanımHaber, Technopat (Turkey) · Nairaland (Nigeria) · MyBroadband (South Africa) |

Added forums include iFixit, Woot, Tesla Motors Club, Cruise Critic, DPReview, AVS Forum, Home Assistant, Mayo Clinic Connect, Overclockers, Wallstreet-Online, Haraj, Yoo7, FXP, India Forums, Adrenaline and Hardmob, MouthShut, Krstarica and Modrykonik.

Popular brands usually return **1,000+ forum mentions per keyword**.

### Pricing

Pricing includes a per-mention charge and an Actor start charge of $0.00005 at the default memory setting.

| Apify plan | Price per 1,000 mentions |
|---|---|
| Free | $1.50 |
| Starter, Scale, Business and above | $0.80 |

A full scan of a popular brand (about 1,800 mentions across 200+ forums) costs about $1.45 on paid plans. Set **Mentions per keyword** to control the cost of each run.

### Input

| Field | What it does |
|---|---|
| **Keywords or brands** | One per line. Use quotes for an exact phrase: `"ikea kallax"`. |
| **Mentions per keyword** | How many threads to collect for each keyword (default 200). Even small values include threads from many different forums. |
| **Time period** | Any time, past year, month, week, day or hour. |
| **Advanced · Regions** | Leave empty for all forums, or pick English-speaking, Europe, Asia, Russia, Latin America, Middle East & Africa. |
| Mention languages | Choose the language of the title and matching excerpt. A language selection also checks both sides of linked replies. |
| Advanced · Forum countries | Choose the country associated with the community. For Italian mentions anywhere select Italian and leave countries empty. For Italian mentions on Italian communities also select IT. |
| Include reply context | Attach pairs of messages on Mumsnet and OzBargain, with both texts and links. Off by default. |
| Community focus | Choose Coffee or Home improvement and furniture for specialist discussions. Leave All communities selected for broad monitoring. |
| Include Reddit | On by default. |
| Include blogs | Off by default. Also search 50 blog platforms (Medium, Substack, Blogspot, WordPress.com, Tumblr, Naver, note, CSDN, Dzen and more). Blog posts come with page type `blog`. |
| Only results that name the keyword | On by default: every row contains all the words of your keyword in the title or text. |
| Include profile and tag pages | Off by default: you get discussions and articles only. |

Example:

```json
{
  "keywords": ["CeraVe", "Cetaphil"],
  "maxResultsPerKeyword": 500,
  "timeRange": "month",
  "regions": ["english", "europe"]
}
```

### Output

Each row describes a matching page for one keyword.

```json
{
  "keyword": "CeraVe",
  "title": "For all you CeraVe haters, what did CeraVe do to your skin ...",
  "url": "https://www.reddit.com/r/SkincareAddiction/comments/13h3p1j/for_all_you_cerave_haters_what_did_cerave_do_to/",
  "forum": "reddit.com",
  "forumName": "Reddit",
  "country": null,
  "region": "english",
  "pageType": "discussion",
  "postedDate": "2023-05-14",
  "mentionText": "Cerave products tend to break me out, cause redness, and general irritation for me. I have reverted back to the Drunk Elephant Jelly Cleanser ( ...",
  "postExcerpt": null,
  "author": "avocadmousse",
  "votes": 339,
  "comments": 302,
  "thumbnail": "https://share.redd.it/preview/post/13h3p1j",
  "mentionsKeyword": true
}
```

| Field | Meaning |
|---|---|
| `keyword` | The keyword that found this thread |
| `title`, `url` | Thread title and link |
| `forum`, `forumName` | Forum domain and name |
| `country`, `region` | Country of the forum (empty for international communities) and region |
| `pageType` | `discussion`, `article`, `blog` when you turn blogs on, or `profile` / `listing` when you turn those on |
| `postedDate` | Date of the post or last activity, when the forum shows it |
| `mentionText`, `postExcerpt` | The text where the keyword is mentioned, and the opening of the post |
| `author`, `votes`, `comments` | Author, vote and comment counts when available |
| `matchType`, `mentionEvidence` | Exact phrase, all terms, or related. Each evidence item quotes a passage and names its field. |
| `replyContext` | Each pair contains `message`, `messagePermalink`, `targetMessage`, `targetPermalink` and `relationType` (directReply or quote). |
| `replyContextStatus` | Review status on eligible rows: reviewed, partial, unavailable or notReviewed. |
| `threadId` | Stable comparison key for discussion rows. Recognized thread links share a key across page variants. |
| `publishedDate`, `dateBasis` | Explicit publication date when available. The basis for postedDate is publication or displayed date. |
| `questionTitle`, `section`, `lastActivityDate`, `answerCount` | Question and discussion context where available. |
| `postPermalink`, `postRole`, `postDate` | Link to an identifiable post, its role and its date when explicitly attributable to that post. |
| `answerPostedDate` | Publication date of the linked accepted answer when available. |
| `acceptedAnswerUrl`, `answerExcerpt` | Explicitly accepted answer and excerpt when available. Credit fields identify question and answer contributors and licenses. |
| `mentionsKeyword` | `true` when the title or text contains every word of the keyword |

The status at the end of the run gives the total and names the keywords without mentions.

The run also saves:

- **SUMMARY**: mentions, requested count, whether that count was reached, reason the run stopped for each keyword and keywords to run again;
- **MARKDOWN**: all mentions grouped by keyword, ready for LLM prompts and reports.

Export as JSON, CSV, Excel or HTML, or read it through the Apify API.

### For AI agents

This Actor works as a tool in MCP clients (Claude, Cursor, ChatGPT via Apify MCP server), LangChain, n8n, Make and Zapier.

- **Use it when** the user asks what people say about a brand, product, drug, car, app or topic in forums; for social listening outside social networks; for "find forum threads about X"; for "BoardReader alternative".
- **Minimal input:** `{"keywords": ["<brand>"], "maxResultsPerKeyword": 100}`.
- **Recent only:** add `"timeRange": "week"`.
- **Read** the `MARKDOWN` record for a compact digest, or the dataset for structured rows.

### FAQ

**How is this different from searching Reddit only?**
Reddit is one of 200 sources. Most brand conversations in Europe and Asia happen on national forums (Mumsnet, ForumFree, Forocoches, Zhihu, PTT, Pantip, Ekşi Sözlük) that Reddit tools never see.

**Is it a BoardReader alternative?**
Yes: keyword search across forums and message boards, with dates, countries and exports, pay per result, no subscription.

**Can I monitor new mentions every day?**
Yes. Save a task with **Time period → Past day** and schedule it in Apify; connect it to Slack, email, a spreadsheet or a webhook.

**Do I need an account on the forums?**
No. Only public threads are returned.

**Which languages work?**
Any. Search the brand as people write it; for local terms add one keyword per language (for example `"crema idratante CeraVe"`).

### Reading specialist answers

Select **Coffee** or **Home improvement and furniture** under Community focus. In the English-speaking region, specialist question rows can include an accepted answer with its permalink, excerpt, author and license. For example, use `espresso grinder`, choose Coffee and export ten discussions. Compare `threadId` across exports to follow the same question.

### More tools for social listening

- [Reddit Scraper](https://apify.com/monkey.d.scraping/reddit-scraper) — posts, comments and subreddit search
- [Telegram Keyword Search](https://apify.com/monkey.d.scraping/telegram-keyword-search-channel-scraper) — mentions in public Telegram channels
- [Facebook Post Search](https://apify.com/monkey.d.scraping/facebook-public-group-mentions) — exact keyword mentions on Facebook
- [TikTok Trends & Search Scraper](https://apify.com/monkey.d.scraping/tiktok-trends-search-scraper) — videos about a brand or topic
- [YouTube Scraper](https://apify.com/monkey.d.scraping/youtube-scraper) — videos, comments and transcripts

### 中文说明

**在线讨论中的品牌提及：一次搜索 200 个论坛和社区中的品牌、产品或关键词提及。**

覆盖 Reddit、Quora、知乎、豆瓣、NGA、Chiphell、V2EX、PTT、Mobile01、Dcard、LIHKG、雅虎知惠袋、价格.com、DCInside、Pantip、Kaskus、Habr、Mumsnet 以及 ForumFree、Forumotion、ProBoards 等托管成千上万小论坛的平台，覆盖 30 多个国家。

**用途**：舆情监测、品牌监控、竞品分析、市场调研、寻找潜在客户讨论。可作为 BoardReader 的替代方案。

**输入**：每行一个关键词或品牌；可设置每个关键词的结果数、时间范围（过去一天/一周/一月/一年）和地区（英语、欧洲、亚洲、俄罗斯、拉美、中东和非洲）。

**输出字段**：关键词、帖子标题、链接、论坛、国家、地区、发帖日期、摘要、帖子开头；Reddit 帖子另含作者、投票数和评论数。同时生成按关键词分组的 Markdown 摘要，可直接用于大模型分析。导出格式：JSON、CSV、Excel。

**按结果付费**：免费套餐每 1,000 条提及 $1.50，付费套餐每 1,000 条 $0.80，已含平台费用。默认内存配置下，每次启动另收 $0.00005。无需论坛账号。

#### 繁體中文

線上討論中的品牌提及：一次搜尋 200 個論壇與社群的品牌與關鍵字討論，涵蓋 PTT、Mobile01、Dcard、LIHKG、知乎、Reddit 等。適用於輿情監測、品牌監控與市場調查，可匯出 CSV、Excel、JSON。付費方案每 1,000 筆 $0.80。

# Actor input Schema

## `keywords` (type: `array`):

One keyword, brand, product or phrase per line. Each one is searched across all forums. Use quotes for an exact phrase, for example "ikea kallax".

## `maxResultsPerKeyword` (type: `integer`):

Maximum forum mentions to collect for each keyword. Popular brands return 1,000+ mentions. Even small values include threads from many different forums.

## `timeRange` (type: `string`):

Only mentions from this period. Use "Past week" or "Past day" for monitoring.

## `languages` (type: `array`):

Keep mentions whose title and excerpt can be identified in a selected language. Leave empty for all languages.

## `countries` (type: `array`):

Choose the country of the community. International communities without a known country are included when this field is empty.

## `regions` (type: `array`):

Search only forums from these regions. Leave empty to search all of them.

## `includeReddit` (type: `boolean`):

Also search Reddit. Turn off if you already monitor Reddit separately.

## `includeBlogs` (type: `boolean`):

Also search 50 blog platforms (Medium, Substack, Blogspot, WordPress.com, Tumblr, Naver, note, CSDN and more). Blog posts come with page type "blog".

## `onlyExplicitMentions` (type: `boolean`):

Keep only threads whose title or text contains every word of the keyword. Turn off to also get related discussions.

## `includeProfilesAndTagPages` (type: `boolean`):

Also return user profiles, tag pages and forum index pages. Off by default: you get discussions and articles only.

## `communityFocus` (type: `string`):

Choose all communities or focus on specialist discussions about coffee or home improvement and furniture. Region choices also apply.

## `includeReplyContext` (type: `boolean`):

Include linked messages and the comments they reply to or quote on supported OzBargain and Mumsnet discussions.

## Actor input object example

```json
{
  "keywords": [
    "CeraVe"
  ],
  "maxResultsPerKeyword": 100,
  "timeRange": "any",
  "languages": [],
  "countries": [],
  "regions": [],
  "includeReddit": true,
  "includeBlogs": false,
  "onlyExplicitMentions": true,
  "includeProfilesAndTagPages": false,
  "communityFocus": "all",
  "includeReplyContext": false
}
```

# Actor output Schema

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

One row per matching page and keyword, including mentionEvidence, matchType, threadId, publishedDate, discussion context and available accepted answers. Core fields include keyword, title, url, forum, forumName, country, region, pageType, postedDate, mentionText, postExcerpt, author, votes, comments, thumbnail, mentionsKeyword.

## `summary` (type: `string`):

Mentions and forums per keyword, and keywords to run again.

## `markdown` (type: `string`):

Mentions grouped by keyword as Markdown, ready for LLM prompts and reports.

# 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 = {
    "keywords": [
        "CeraVe"
    ],
    "maxResultsPerKeyword": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/forum-search-engine").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 = {
    "keywords": ["CeraVe"],
    "maxResultsPerKeyword": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/forum-search-engine").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 '{
  "keywords": [
    "CeraVe"
  ],
  "maxResultsPerKeyword": 100
}' |
apify call monkey.d.scraping/forum-search-engine --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/forum-search-engine"
        }
    }
}
```

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/u8ctFMOFhXjpgdgVT/builds/qFV0EHdt0WTnk2Jax/openapi.json
