🔍 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): json { "query": "tutorial", "type": "videos", "maxResults": 50 } Or simply use the defaults by providing an empty input or just the query: json { "query": "tutorial" } ### Example 2: Search with Filters Get English-language programming tutorials, sorted by newest: json { "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": json { "query": "music", "type": "playlists", "maxResults": 50 } ### Example 4: Search Channels Discover channels about "technology": json { "query": "technology", "type": "channels", "maxResults": 50 } ### Example 5: Live Videos Only Get only live streams for "gaming": json { "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: json { "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