# Goonchan Video Downloader | How to Download Goonchan Videos (`videodownloaders/goonchan-video-downloader-how-to-download-goonchan-videos`) Actor

- **URL**: https://apify.com/videodownloaders/goonchan-video-downloader-how-to-download-goonchan-videos.md
- **Developed by:** [videodownloaders](https://apify.com/videodownloaders) (community)
- **Categories:** Videos, Automation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Goonchan Video Downloader | How to Download Goonchan Videos

> Download videos from GoonChan pages with a simple browser workflow, player button support, and compact on-page detection.

### Get it Here

Get it here: https://serp.ly/goonchan-downloader

![Goonchan Downloader](https://apps.serp.co/media/optimized-products/goonchan-downloader-homescreen-adult-79564da817.webp)

Goonchan Downloader is a browser extension designed for GoonChan's `/video/` page pattern, giving you a quick way to detect and save videos without leaving the page. Instead of digging through page source or using clunky third-party tools, this extension keeps the workflow inside your browser with on-page controls and a dedicated player button. It pairs chan-style site branding with a browser-native download experience that works across the main domain and matching subdomains.

- Browser-native video detection on GoonChan `/video/` pages
- Player button integration with the video player area
- Shared download manager for in-progress downloads
- Offscreen download defaults configured for GoonChan
- Solid browser-network handoff with verified target matching
### Table of Contents

- [Why Goonchan Downloader](#why-goonchan-downloader)
- [Features](#features)
- [How It Works](#how-it-works)
- [Step-by-Step Tutorial: How to Download Videos from Goonchan](#step-by-step-tutorial-how-to-download-videos-from-goonchan)
- [Supported Formats](#supported-formats)
- [Who It's For](#who-its-for)
- [Common Use Cases](#common-use-cases)
- [Troubleshooting](#troubleshooting)
- [Trial & Access](#trial--access)
- [Installation Instructions](#installation-instructions)
- [FAQ](#faq)
- [Notes](#notes)
- [License](#license)
- [About Goonchan](#about-goonchan)

### Why Goonchan Downloader

GoonChan hosts video content on its `/video/` pages, but the media links are not always obvious from the page alone. Generic downloader sites can feel clumsy or overbroad, and users often want a direct, in-browser action tied to the player area rather than copying URLs into external tools.

Goonchan Downloader solves this by providing a focused workflow for GoonChan's page pattern. It detects likely video candidates from media tags and metadata already exposed in the page, then lets you save them with a single click from the player button or extension popup. The entire process stays inside your browser, and the offscreen download defaults are already configured for GoonChan.

### Features

- GoonChan-specific identity and page matching for main domain and subdomains
- Player button attachment to the video player wrapper
- Generic media detection using page tags and metadata
- Shared in-page download manager with progress tracking
- Offscreen download folder defaults set to GoonChan
- Context menu support for quick access
- Desktop notifications when downloads complete
- Auto-save configuration for streamlined workflows

### How It Works

1. Install the extension from the latest release.
2. Open GoonChan and go to a supported video page.
3. Start playback so the extension can detect the media.
4. Open the popup or use the on-page controls.
5. Choose the quality option you want.
6. Start the download and wait for the MP4 export to finish.
7. Save the final file locally.

### Step-by-Step Tutorial: How to Download Videos from Goonchan

1. Install the Goonchan Downloader extension from the latest release.
2. Navigate to a GoonChan video page with a URL like `/video/your-video-slug`.
3. Wait for the page to fully load and the video player to appear.
4. Look for the player button attached to the video player area.
5. Click the player button or open the extension popup to view detected media.
6. Select the quality option you prefer from the available choices.
7. Click the download button to start the export process.
8. Save the MP4 file to your preferred location when the download finishes.

### Supported Formats

- Input: Direct video candidates detected from page media tags and metadata
- Output: MP4

Saved files use MP4 so they are easier to replay on standard media players, move between devices, or archive locally.

### Who It's For

- Users who browse GoonChan and want a simple page-level download workflow
- People who prefer in-browser tools over copy-and-paste download sites
- Viewers who want to save GoonChan videos for offline viewing
- Users who want a downloader that matches GoonChan's community-style identity

### Common Use Cases

- Save a GoonChan video from a `/video/` page for offline playback
- Archive personal content you have uploaded to GoonChan
- Keep a local copy of videos you want to reference later
- Download videos to share through other platforms
- Build a personal library of GoonChan content you own or have permission to save

### Troubleshooting

**The extension does not detect any media on the page.**
Make sure the video is playing or has loaded in the player area before checking the extension. Some pages may require the media element to be active before detection works.

**The player button does not appear.**
Verify you are on a supported GoonChan `/video/` page. The player button attaches to a specific player wrapper and may not appear on all page types.

**Downloads fail or freeze partway through.**
Check your internet connection and make sure the page remains open during the download. Try refreshing the page and starting again.

**The extension popup shows no candidates.**
The current detection approach uses generated direct-video stubs that still need review. If no candidates appear, the page may not expose media in a way the extension can detect yet.

**I see an error about missing permissions.**
Make sure you have granted the necessary permissions during installation. You may need to reinstall the extension from the latest release.

### Trial & Access

- Includes **3 free downloads** so you can test the workflow first
- Email sign-in uses secure one-time password verification
- No credit card required for the trial
- Unlimited downloads are available with a paid license

Start here: [https://serp.ly/goonchan-downloader](https://serp.ly/goonchan-downloader)

### Installation Instructions

1. Open the latest release page: [GitHub Releases](https://github.com/serpcompany/goonchan-downloader/releases/latest)
2. Download the correct build for your browser.
3. Install the extension.
4. Open a supported GoonChan page.
5. Use the popup to detect and download the media.

### FAQ

**What pages does this extension work on?**
The clearest fit is GoonChan's `/video/` page style, plus matching main-domain and subdomain coverage.

**Does the extension require any account to use?**
You can use the trial downloads without an account. For unlimited access, you will need a paid license and email sign-in.

**Is this extension ready for public release?**
The extension has strong target verification and solid browser-network handoff confidence. However, the current extraction path still depends on generated direct-video stubs that need real review before full release.

**Can I download multiple videos at once?**
The extension supports one download at a time through the download manager. Bulk download functionality is not currently available.

**What happens if I close the page during a download?**
Closing the page may interrupt the download. Keep the page open until the download completes.

### Notes

- Only download content you own or have explicit permission to save
- An internet connection is required for downloads
- The extension is built around GoonChan's `/video/` page pattern and may not work on other page types
- Current detection uses generated stubs that still need manual review before full release

### License

This repository is distributed under the proprietary SERP Apps license in the [LICENSE](https://github.com/serpcompany/goonchan-downloader/blob/main/LICENSE) file. Review that file before copying, modifying, or redistributing any part of this project.

### About Goonchan

GoonChan is a community-style platform that hosts video content across its main domain and subdomains. Goonchan Downloader is built to match GoonChan's page patterns and identity, giving users a focused download workflow that stays inside the browser rather than relying on generic tools.

# Actor input Schema



## Actor input object example

```json
{}
````

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("videodownloaders/goonchan-video-downloader-how-to-download-goonchan-videos").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("videodownloaders/goonchan-video-downloader-how-to-download-goonchan-videos").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call videodownloaders/goonchan-video-downloader-how-to-download-goonchan-videos --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=videodownloaders/goonchan-video-downloader-how-to-download-goonchan-videos",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Goonchan Video Downloader | How to Download Goonchan Videos",
        "version": "0.0",
        "x-build-id": "Ac9j36PsMpqdYMKut"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/videodownloaders~goonchan-video-downloader-how-to-download-goonchan-videos/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-videodownloaders-goonchan-video-downloader-how-to-download-goonchan-videos",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/videodownloaders~goonchan-video-downloader-how-to-download-goonchan-videos/runs": {
            "post": {
                "operationId": "runs-sync-videodownloaders-goonchan-video-downloader-how-to-download-goonchan-videos",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/videodownloaders~goonchan-video-downloader-how-to-download-goonchan-videos/run-sync": {
            "post": {
                "operationId": "run-sync-videodownloaders-goonchan-video-downloader-how-to-download-goonchan-videos",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {}
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
