🔍 SepiaSearch Scraper

Extract search results from SepiaSearch.org, the leading search engine for PeerTube videos, playlists, and channels. Get titles, URLs, descriptions, and metadata from any search query with automatic pagination support.

---

✨ Why Use SepiaSearch Scraper?

• ⚡ Fast & Efficient - Direct API integration delivers results in seconds
• 🎯 Comprehensive Search - Search across videos, playlists, and channels from the entire PeerTube network
• 📈 Scalable - Scrape from 20 to 500 results with automatic pagination
• 🔍 Advanced Filtering - Filter by language, category, duration, license, NSFW content, and more
• 📊 Clean Output - Structured JSON data ready for analysis, integration, or export

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
query	String	✅ Yes	tutorial	Search term to query on SepiaSearch.org
type	String	✅ Yes	videos	Type of results: videos, playlists, or channels
maxResults	Integer	❌ No	50	Maximum number of results to collect (range: 20-500)
nsfw	String	❌ No	no	Include NSFW content: yes or no
language	String	❌ No	any	Filter by language (e.g., en, fr, de, es, ru, etc.)
sort	String	❌ No	best	Sort order: best, -publishedAt (newest), or publishedAt (oldest)
duration	String	❌ No	any	Video duration filter: any, short (0-4min), medium (4-10min), or long (10+min)
category	String	❌ No	any	Video category (1-18, e.g., 1=Music, 7=Gaming, 13=Education)
display	String	❌ No	any	Filter by live/VOD: any, true (live only), or false (VOD only)
license	String	❌ No	any	License type (1-7, e.g., 1=Attribution, 7=Public Domain)

Note: SepiaSearch returns 20 results per page. The Actor automatically handles pagination to reach your desired maxResults. The default query is tutorial if not specified.

---

📖 Usage Examples

Example 1: Basic Video Search (Default)

Run with default parameters (query: "tutorial", type: "videos", maxResults: 50):

{
  "query": "tutorial",
  "type": "videos",
  "maxResults": 50
}

Or simply use the defaults by providing an empty input or just the query:

{
  "query": "tutorial"
}

Example 2: Search with Filters

Get English-language programming tutorials, sorted by newest:

{
  "query": "programming tutorial",
  "type": "videos",
  "maxResults": 100,
  "language": "en",
  "sort": "-publishedAt",
  "duration": "medium",
  "category": "13",
  "nsfw": "no"
}

Example 3: Search Playlists

Find playlists about "music":

{
  "query": "music",
  "type": "playlists",
  "maxResults": 50
}

Example 4: Search Channels

Discover channels about "technology":

{
  "query": "technology",
  "type": "channels",
  "maxResults": 50
}

Example 5: Live Videos Only

Get only live streams for "gaming":

{
  "query": "gaming",
  "type": "videos",
  "display": "true",
  "maxResults": 50
}

---

📤 Output Data

Each result includes different fields depending on the type:

Videos & Livestreams

Field	Type	Description
url	String	Direct link to the video
title	String	Video title
description	String	Video description (truncated to 300 chars)
author	Object/null	Channel information (name, url, avatar). url and avatar can be null
date	Integer/null	Publication date as Unix timestamp (null if unavailable)
duration	Integer/String/null	Duration in seconds, _LIVE for livestreams, or null
views	Integer/null	Number of views (null if unavailable)
thumb	Object	Thumbnail information (ratio and url can be null)
resultType	String	video or livestream

Playlists

Field	Type	Description
url	String	Direct link to the playlist
title	String	Playlist name
description	String	Playlist description
author	Object/null	Owner information (name, url, avatar). url and avatar can be null
date	Integer/null	Creation date as Unix timestamp (null if unavailable)
duration	Integer/null	Total duration of all videos in playlist (null if unavailable)
views	null	Always null for playlists
thumb	Object	Thumbnail information (ratio and url can be null)
resultType	String	playlist

Channels

Field	Type	Description
url	String	Direct link to the channel
title	String	Channel name and handle
description	String	Channel description with video count
author	null	Always null for channels
date	null	Always null for channels
duration	null	Always null for channels
views	null	Always null for channels
followers	Integer/null	Number of followers (null if unavailable)
thumb	Object	Channel avatar (1:1 ratio, ratio and url can be null)
resultType	String	channel

Sample Output

Video Example:

{
  "url": "https://example.tube/videos/watch/abc123",
  "title": "Introduction to JavaScript",
  "description": "Learn the basics of JavaScript programming...",
  "author": {
    "name": "Tech Channel (techchannel)",
    "url": "https://example.tube/c/techchannel",
    "avatar": "https://example.tube/avatars/techchannel.jpg"
  },
  "date": 1704067200,
  "duration": 1200,
  "views": 5432,
  "thumb": {
    "ratio": "16:9",
    "url": "https://example.tube/thumbnails/abc123.jpg"
  },
  "resultType": "video"
}

Note: Some fields like author.avatar, author.url, date, views, and duration can be null if the data is not available from the source.

Data is delivered in clean JSON format, ready to download as JSON, CSV, Excel, or integrate via API.

---

🌍 Supported Languages

The scraper supports filtering by the following languages:

any, en (English), fr (Français), ar (العربية), ca (Català), cs (Čeština), de (Deutsch), el (ελληνικά), eo (Esperanto), es (Español), eu (Euskara), fa (فارسی), fi (Suomi), gd (Gàidhlig), gl (Galego), hr (Hrvatski), hu (Magyar), is (Íslenska), it (Italiano), ja (日本語), kab (Taqbaylit), nl (Nederlands), no (Norsk), oc (Occitan), pl (Polski), pt (Português Brasil), pt-PT (Português Portugal), ru (Pусский), sk (Slovenčina), sq (Shqip), sv (Svenska), th (ไทย), tok (Toki Pona), tr (Türkçe), uk (украї́нська), vi (Tiếng Việt), zh-Hans (简体中文), zh-Hant (繁體中文)

---

📂 Video Categories

When searching for videos, you can filter by category:

• 1 - Music
• 2 - Films
• 3 - Vehicles
• 4 - Art
• 5 - Sports
• 6 - Travels
• 7 - Gaming
• 8 - People
• 9 - Comedy
• 10 - Entertainment
• 11 - News & Politics
• 12 - How To
• 13 - Education
• 14 - Activism
• 15 - Science & Technology
• 16 - Animals
• 17 - Kids
• 18 - Food

---

📜 License Types

When searching for videos, you can filter by license:

• 1 - Attribution
• 2 - Attribution - Share Alike
• 3 - Attribution - No Derivatives
• 4 - Attribution - Non Commercial
• 5 - Attribution - Non Commercial - Share Alike
• 6 - Attribution - Non Commercial - No Derivatives
• 7 - Public Domain Dedication

---

❓ FAQ

Q: How many results can I scrape?

A: You can scrape between 20 and 500 results per run.

Q: How long does it take?

A: Typically <10 seconds for 50 results, depending on SepiaSearch API response times.

Q: Can I search for live streams?

A: Yes! Set display: "true" to get only live videos, or display: "false" for VODs only.

Q: What's the difference between videos, playlists, and channels?

A:

• Videos: Individual video content
• Playlists: Collections of videos
• Channels: PeerTube channels/accounts

Q: Can I filter by multiple languages?

A: Currently, you can filter by one language at a time. Use any to get results in all languages.

Q: What if SepiaSearch changes their API?

A: The Actor is designed to handle API changes gracefully. If issues occur, we update promptly.

---

🔗 About SepiaSearch

SepiaSearch is a search engine for the PeerTube federated video platform network. It indexes content from thousands of PeerTube instances, making it easy to discover videos, playlists, and channels across the entire network.

Learn more: https://sepiasearch.org