# 4chan

> Read 4chan: list boards and their threads, read whole threads as plain text, browse a board's archive and download images, and start workflows on new threads or replies. No account needed.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/fourchan

## Actions

### Download file

Download a post's image or video as a file, so a later step can save it, attach it to an email or post it elsewhere.

**Inputs**

- File address (`file_url`, text, required): The post's file_url, from 'Get thread', 'List threads' or a trigger, e.g. https://i.4cdn.org/g/1792335004938438.png.

**Outputs**

- `board` (text): The board the file was posted on.
- `byte_size` (number): The file's size in bytes.
- `content_type` (text): The file's type, e.g. image/png or video/webm.
- `document_ref` (text): The stored file's reference.
- `documents` (list): The downloaded file as a document, ready to attach to a later step.
- `filename` (text): The file's name.
- `source_url` (text): The file's address on 4chan.
- `url` (text): A link that serves the stored file.

**Example output**

```json
{
  "board": "g",
  "byte_size": 1846624,
  "content_type": "image/png",
  "document_ref": "doc_5c1e0f3a9b2d4e6f8a7b6c5d4e3f2a1b",
  "documents": [
    {
      "content_type": "image/png",
      "document_ref": "doc_5c1e0f3a9b2d4e6f8a7b6c5d4e3f2a1b",
      "filename": "1792335004938438.png",
      "size_bytes": 1846624,
      "url": "/actions/core/serve-document/doc_5c1e0f3a9b2d4e6f8a7b6c5d4e3f2a1b"
    }
  ],
  "filename": "1792335004938438.png",
  "source_url": "https://i.4cdn.org/g/1792335004938438.png",
  "url": "/actions/core/serve-document/doc_5c1e0f3a9b2d4e6f8a7b6c5d4e3f2a1b"
}
```

### Get board

Get one board's title, description, address, whether it is work-safe and has an archive, and its limits on files, comments and threads.

**Inputs**

- Board (`board`, text, required): The 4chan board, e.g. Technology (/g/). From an earlier step, give its short name, such as g.

**Outputs**

- `board` (object): The board.

**Example output**

```json
{
  "board": {
    "bump_limit": 310,
    "code": "g",
    "description": "\"/g/ - Technology\" is 4chan's imageboard for discussing computer hardware and software, programming, and general technology.",
    "has_archive": true,
    "image_limit": 150,
    "label": "Technology (/g/)",
    "max_comment_length": 2000,
    "max_file_size_bytes": 4194304,
    "new_thread_cooldown_seconds": 600,
    "pages": 10,
    "reply_cooldown_seconds": 60,
    "shows_country_flags": false,
    "shows_poster_ids": false,
    "text_only": false,
    "threads_per_page": 15,
    "title": "Technology",
    "url": "https://boards.4chan.org/g/",
    "work_safe": true
  }
}
```

### Get thread

Get a thread and every reply in it, oldest first, as plain text with links to each post and its image. Optionally only the posts that mention a word. Works for archived threads too.

**Inputs**

- Board (`board`, text, required): The 4chan board, e.g. Technology (/g/). From an earlier step, give its short name, such as g.
- Thread (`thread`, text, required): The thread's number, e.g. 110102853, or its link, e.g. https://boards.4chan.org/g/thread/110102853.
- Only posts mentioning (`contains`, text): Only posts whose comment or subject mention this word or phrase. Capitals are ignored. Leave empty for every post.

**Outputs**

- `count` (number): How many posts are returned.
- `posts` (list): The posts, oldest first, starting with the opening post.
- `thread` (object): The thread, described by its opening post.
- `total_posts` (number): How many posts the thread has, the opening post included.

**Example output**

```json
{
  "count": 2,
  "posts": [
    {
      "author_name": "Anonymous",
      "board": "g",
      "capcode": "",
      "comment": ">new UI is actually good\nI think 2027 will be the year Firefox bounces back.",
      "comment_html": "<span class=\"quote\">&gt;new UI is actually good</span><br>I think 2027 will be the year Firefox bounces back.",
      "country_code": "",
      "country_name": "",
      "created_at": "2026-10-18T14:50:04Z",
      "file_deleted": false,
      "file_height": 3840,
      "file_name": "firefox_logo.png",
      "file_size_bytes": 1846624,
      "file_spoilered": false,
      "file_url": "https://i.4cdn.org/g/1792335004938438.png",
      "file_width": 3840,
      "is_opening_post": true,
      "number": 110102853,
      "poster_id": "",
      "quoted_posts": [],
      "subject": "Is Firefox making a comeback?",
      "thread_number": 110102853,
      "thumbnail_url": "https://i.4cdn.org/g/1792335004938438s.jpg",
      "tripcode": "",
      "url": "https://boards.4chan.org/g/thread/110102853"
    },
    {
      "author_name": "Anonymous",
      "board": "g",
      "capcode": "",
      "comment": ">>110102853\nNot really, people are talking about other browsers more.",
      "comment_html": "<a href=\"#p110102853\" class=\"quotelink\">&gt;&gt;110102853</a><br>Not really, people are talking about other browsers more.",
      "country_code": "",
      "country_name": "",
      "created_at": "2026-10-19T18:39:02Z",
      "file_deleted": false,
      "file_height": null,
      "file_name": "",
      "file_size_bytes": null,
      "file_spoilered": false,
      "file_url": "",
      "file_width": null,
      "is_opening_post": false,
      "number": 110113447,
      "poster_id": "",
      "quoted_posts": [
        110102853
      ],
      "subject": "",
      "thread_number": 110102853,
      "thumbnail_url": "",
      "tripcode": "",
      "url": "https://boards.4chan.org/g/thread/110102853#p110113447"
    }
  ],
  "thread": {
    "archived_at": null,
    "author_name": "Anonymous",
    "board": "g",
    "capcode": "",
    "comment": ">new UI is actually good\nI think 2027 will be the year Firefox bounces back.",
    "comment_html": "<span class=\"quote\">&gt;new UI is actually good</span><br>I think 2027 will be the year Firefox bounces back.",
    "country_code": "",
    "country_name": "",
    "created_at": "2026-10-18T14:50:04Z",
    "file_deleted": false,
    "file_height": 3840,
    "file_name": "firefox_logo.png",
    "file_size_bytes": 1846624,
    "file_spoilered": false,
    "file_url": "https://i.4cdn.org/g/1792335004938438.png",
    "file_width": 3840,
    "images": 5,
    "is_archived": false,
    "is_closed": false,
    "is_sticky": false,
    "last_activity_at": "2026-10-19T22:30:23Z",
    "latest_replies": [],
    "number": 110102853,
    "page": null,
    "poster_id": "",
    "reached_bump_limit": false,
    "reached_image_limit": false,
    "replies": 65,
    "subject": "Is Firefox making a comeback?",
    "thumbnail_url": "https://i.4cdn.org/g/1792335004938438s.jpg",
    "title": "Is Firefox making a comeback?",
    "tripcode": "",
    "unique_posters": 31,
    "url": "https://boards.4chan.org/g/thread/110102853"
  },
  "total_posts": 2
}
```

### List archived threads

List the threads in a board's archive, most recently archived first: threads that fell off the board in the last few days and can still be read with 'Get thread'. Not every board has an archive.

**Inputs**

- Board (`board`, text, required): The 4chan board, e.g. Technology (/g/). From an earlier step, give its short name, such as g.
- How many (`limit`, number): The most threads to return, newest first, 1 to 3000. Defaults to 50. From 1 to 3000.

**Outputs**

- `board` (text): The board's short name, e.g. 'g'.
- `count` (number): How many threads are returned.
- `threads` (list): The archived threads, most recently archived first.
- `total` (number): How many threads the archive holds.

**Example output**

```json
{
  "board": "g",
  "count": 1,
  "threads": [
    {
      "number": 110111193,
      "url": "https://boards.4chan.org/g/thread/110111193"
    }
  ],
  "total": 1758
}
```

### List boards

List every board on 4chan with its title, description, whether it is work-safe, whether it has an archive, and its limits.

**Inputs**

- Work-safe boards only (`work_safe_only`, true/false): Leave out the boards with adult content. Default: `false`.

**Outputs**

- `boards` (list): The boards, by title.
- `count` (number): How many boards are returned.

**Example output**

```json
{
  "boards": [
    {
      "bump_limit": 310,
      "code": "g",
      "description": "\"/g/ - Technology\" is 4chan's imageboard for discussing computer hardware and software, programming, and general technology.",
      "has_archive": true,
      "image_limit": 150,
      "label": "Technology (/g/)",
      "max_comment_length": 2000,
      "max_file_size_bytes": 4194304,
      "new_thread_cooldown_seconds": 600,
      "pages": 10,
      "reply_cooldown_seconds": 60,
      "shows_country_flags": false,
      "shows_poster_ids": false,
      "text_only": false,
      "threads_per_page": 15,
      "title": "Technology",
      "url": "https://boards.4chan.org/g/",
      "work_safe": true
    }
  ],
  "count": 1
}
```

### List threads

List the live threads on a board, or only those whose subject or opening post mention a word: each with its subject, text, image, reply count, link and newest replies.

**Inputs**

- Board (`board`, text, required): The 4chan board, e.g. Technology (/g/). From an earlier step, give its short name, such as g.
- Only threads mentioning (`contains`, text): Only threads whose subject or opening comment mention this word or phrase. Capitals are ignored. Leave empty for every thread.
- Order (`sort_by`, text): Which threads come first. Defaults to the board's own order. One of: `bumped` (Most recently active first, as 4chan lists them), `newest` (Newest threads first), `replies` (Most replies first).
- How many (`limit`, number): The most threads to return, 1 to 200. Defaults to 50. From 1 to 200.

**Outputs**

- `board` (text): The board's short name, e.g. 'g'.
- `count` (number): How many threads are returned.
- `matching` (number): How many live threads mention the word, before the limit.
- `threads` (list): The threads, each described by its opening post.
- `total_on_board` (number): How many live threads the board has.

**Example output**

```json
{
  "board": "g",
  "count": 1,
  "matching": 1,
  "threads": [
    {
      "archived_at": null,
      "author_name": "Anonymous",
      "board": "g",
      "capcode": "",
      "comment": ">new UI is actually good\nI think 2027 will be the year Firefox bounces back.",
      "comment_html": "<span class=\"quote\">&gt;new UI is actually good</span><br>I think 2027 will be the year Firefox bounces back.",
      "country_code": "",
      "country_name": "",
      "created_at": "2026-10-18T14:50:04Z",
      "file_deleted": false,
      "file_height": 3840,
      "file_name": "firefox_logo.png",
      "file_size_bytes": 1846624,
      "file_spoilered": false,
      "file_url": "https://i.4cdn.org/g/1792335004938438.png",
      "file_width": 3840,
      "images": 5,
      "is_archived": false,
      "is_closed": false,
      "is_sticky": false,
      "last_activity_at": "2026-10-19T22:30:23Z",
      "latest_replies": [
        {
          "author_name": "Anonymous",
          "board": "g",
          "capcode": "",
          "comment": ">>110102853\nNot really, people are talking about other browsers more.",
          "comment_html": "<a href=\"#p110102853\" class=\"quotelink\">&gt;&gt;110102853</a><br>Not really, people are talking about other browsers more.",
          "country_code": "",
          "country_name": "",
          "created_at": "2026-10-19T18:39:02Z",
          "file_deleted": false,
          "file_height": null,
          "file_name": "",
          "file_size_bytes": null,
          "file_spoilered": false,
          "file_url": "",
          "file_width": null,
          "is_opening_post": false,
          "number": 110113447,
          "poster_id": "",
          "quoted_posts": [
            110102853
          ],
          "subject": "",
          "thread_number": 110102853,
          "thumbnail_url": "",
          "tripcode": "",
          "url": "https://boards.4chan.org/g/thread/110102853#p110113447"
        }
      ],
      "number": 110102853,
      "page": 2,
      "poster_id": "",
      "reached_bump_limit": false,
      "reached_image_limit": false,
      "replies": 65,
      "subject": "Is Firefox making a comeback?",
      "thumbnail_url": "https://i.4cdn.org/g/1792335004938438s.jpg",
      "title": "Is Firefox making a comeback?",
      "tripcode": "",
      "unique_posters": 31,
      "url": "https://boards.4chan.org/g/thread/110102853"
    }
  ],
  "total_on_board": 150
}
```
