Pricing

Rating

Developer

Actor stats

Categories

Share

🔍 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

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

Playlists

Channels

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