# 5ch Thread Tracker — 5ちゃんねる API (`nexgendata/5ch-thread-tracker`) Actor

Track Japan 5ch (5channel) threads and posts. Clean JSON for analysts, quants and AI agents.

- **URL**: https://apify.com/nexgendata/5ch-thread-tracker.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $100.00 / 1,000 thread posts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 5ch Thread Tracker

Track Japan 5ch (5channel) threads and posts. Built for analysts, quants, fintech builders and AI agents.

### 📊 What you get

Clean JSON, one record per item (full output has 8 fields):

- `as_of_timestamp` — As of timestamp
- `board` — Board
- `last_active` — Last active
- `post_count` — Post count
- `thread_id` — Thread id
- `thread_url` — Thread url
- `title` — Title

**Pricing:** $0.10 per item (Pay-Per-Event) — about **10 items per $1**.

### 🤖 Use with AI agents

Structured JSON built for LLM and agent pipelines — point Claude, the OpenAI Agents SDK, an n8n flow or any MCP-aware client at it and pull Japan 5ch (5channel) thread and post tracking on demand.

**Sample agent prompt:**

```
Track 5ch threads on a topic and return the latest posts.
```

**Agentic payments (x402):** Supports agentic payment via x402 — agents can call this actor with USDC, no API key required.

### ⏰ Run on a schedule

This is a monitoring play — schedule a recurring pull:

```json
{
  "limit": 50
}
```

### 日本語について

この Actor は日本の 5ちゃんねる（5ch）のスレッド・投稿データをクリーンな JSON で提供します。アナリスト、クオンツ、フィンテック開発者、AI エージェント向けに設計されています。「アイテム」ごとに課金され（1ドルあたり約 10 件）、定期実行に対応しているため、5ch スレッドの追跡を毎日・毎週自動で取得できます。

### 🔗 Related Japan actors

**China data suite:** [EDINET Filings](https://apify.com/nexgendata/japan-edinet-insider-filings), [TDnet Disclosures](https://apify.com/nexgendata/japan-tdnet-timely-disclosures), [JPX Short Selling](https://apify.com/nexgendata/japan-jpx-short-selling-balances), [Houjin Registry](https://apify.com/nexgendata/japan-houjin-bangou-corporate-registry)

**Cross-market hubs:** [APAC Disclosure Monitor](https://apify.com/nexgendata/apac-disclosure-monitor), [APAC IPO Calendar Sweep](https://apify.com/nexgendata/apac-ipo-calendar-sweep)

***

*Data from public Japanese market and government sources.*

# Actor input Schema

## `mode` (type: `string`):

What to collect. 'board-threads' = list the active thread list for a board (titles + post counts + URLs) from subject.txt — best for trend / buzz monitoring. 'thread-posts' = read every post in one thread (supply threadUrl) — best for sentiment, RAG corpora and full-text mining. 'search' = list a board's threads then keep only those whose title contains your keyword.

## `board` (type: `string`):

5ch board slug to read (used by board-threads and search). Examples: 'newsplus' (ニュース速報+, the main news board), 'news4vip' (ニュー速VIP), 'mnewsplus' (芸スポ速報+ / entertainment & sports), 'seijinewsplus' (政治ニュース+ / politics). The actor resolves the board's server automatically from the live 5ch board directory (bbsmenu).

## `threadUrl` (type: `string`):

Full 5ch thread URL to read posts from, e.g. https://asahi.5ch.net/test/read.cgi/newsplus/1781497598/ . Required when mode='thread-posts'. You can get these URLs from a board-threads run (thread\_url field).

## `keyword` (type: `string`):

When mode='search', keep only threads whose title contains this string (case-insensitive substring match). Japanese or English. Ignored in other modes.

## `maxItems` (type: `integer`):

Hard cap on records returned per run. In board-threads/search mode each record is a thread; in thread-posts mode each record is a single post. 15-50 is typical for monitoring; a busy thread can have 1000+ posts.

## `proxyConfiguration` (type: `object`):

Apify proxy. 5ch is open over plain HTTP, so the default datacenter Apify Proxy is fine. Add a Japan-egress / residential group if you hit occasional rate-limiting on heavy runs.

## `notionConnector` (type: `string`):

Optional. Connect your Notion workspace and the results are also written as a Notion page in the same run — the Actor never sees your Notion credentials. Authorize a Notion MCP connector in Apify Console → Settings → API & Integrations, then select it here.

## `notionParentId` (type: `string`):

Optional. The Notion page ID to create the page under. If blank, Notion creates a private page in your workspace.

## `supabaseConnector` (type: `string`):

Optional. Connect your own Supabase project and the results are also inserted into a table in the same run — the Actor never sees your Supabase credentials. Authorize a write-scoped, project-scoped Supabase MCP connector in Apify Console (Settings -> Integrations), then select it here.

## `supabaseTable` (type: `string`):

Target table in the public schema (created if missing, with id, a jsonb data column, and a scraped\_at timestamp). Default: nexgendata\_leads.

## `supabaseProjectId` (type: `string`):

Your Supabase project reference (e.g. abcdefghijklmnop). Required unless your connector URL is already project-scoped. Find it in your project URL: supabase.com/dashboard/project/THIS\_PART.

## `deliveryDedup` (type: `boolean`):

When on (default), records already delivered in a previous run are not delivered again to the same destination — so scheduled runs only push new items. Turn off to deliver every record on every run.

## Actor input object example

```json
{
  "mode": "board-threads",
  "board": "newsplus",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "supabaseTable": "nexgendata_leads",
  "deliveryDedup": true
}
```

# Actor output Schema

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

5ch board threads or posts returned by the selected tracker mode.

# 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 = {
    "mode": "board-threads",
    "board": "newsplus",
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/5ch-thread-tracker").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 = {
    "mode": "board-threads",
    "board": "newsplus",
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/5ch-thread-tracker").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 '{
  "mode": "board-threads",
  "board": "newsplus",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call nexgendata/5ch-thread-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nexgendata/5ch-thread-tracker"
        }
    }
}

```

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/p98gdJpypWDbkjOGy/builds/vv5GtyZGufOv4Oqd0/openapi.json