PeerSeek

Frequently Asked Questions

Tips for getting the most out of PeerSeek search.

Search modifiers

How do I search for an exact phrase?

Wrap words in double quotes to match them as an exact phrase.
Try it: "free software" — finds videos containing that exact phrase rather than videos that simply mention both words separately.

How do I exclude a word from results?

Put a minus sign directly before a word to exclude it from results.
Try it: linux -ubuntu — finds videos about Linux that do not mention Ubuntu.

Can I filter results by date?

Use before: and after: followed by a date in YYYY-MM-DD format.
Try it: blender after:2025-01-01 — finds Blender videos published since the start of 2025.

Can I combine these modifiers?

Yes, all modifiers work together in a single query.
Search modifier syntax
Modifier Syntax Effect
Exact phrase "words here" Matches the exact phrase
Exclude -word Removes results containing the word
After date after:YYYY-MM-DD Only results published on or after the date
Before date before:YYYY-MM-DD Only results published before the date
Try it: "open source" privacy -google after:2024-01-01

General

What is PeerSeek?

PeerSeek is a search engine for PeerTube (opens in new tab), the federated video platform. It crawls hundreds of PeerTube instances, indexes their videos, and lets you search across all of them from one place — no account required.

My PeerTube instance is not listed — how can I add it?

PeerSeek discovers instances automatically from the PeerTube instance index (opens in new tab). If your instance is not showing up:
  • Make sure your instance is registered in the index.
  • Make sure your robots.txt does not block PeerSeek crawler traffic. Add an allow entry such as:
    User-agent: PeerSeekCrawler
    Allow: /
Once listed and allowed, it will be picked up by the next crawl cycle (typically within a few hours).

Personalization

How does personalization work?

PeerSeek uses a random, anonymous token stored in your browser's local storage to learn from your searches and clicks. Over time, topics, channels, and tags you interact with get a small ranking boost in your home feed and search results. No account, email, or login is involved — the token is a random string that cannot be traced back to you. Inactive personalization profiles are automatically cleaned up after 30 days without use.

How do I reset or remove personalization?

Clear your browser's local storage for this site. In most browsers you can do this via Developer Tools → Application → Local Storage, then delete the entry for peerseek.video. Alternatively, clearing all site data for this origin in your browser settings will also remove it. A new anonymous token is generated automatically on your next visit.

API

Is there a search API?

Yes. PeerSeek exposes a read-only JSON endpoint. No API key or account is required.
GET https://peerseek.video/v1/search?q=blender
All the search modifiers from above ("exact phrase", -exclude, after:, before:) go inside the q parameter, URL-encoded.

What query parameters are supported?

Search API query parameters
Parameter Description
q Search query, including modifiers (required for results).
sort relevance (default), date, views, or trending.
category Filter by category label (see /v1/filters).
language Filter by language code (e.g. en).
instance Limit results to a single instance host.
include_nsfw true to include NSFW results (default false).
page Page number, starting at 1.
size Results per page, 1100 (default 24).
Example: /v1/search?q="open source" -google after:2024-01-01&sort=date&size=10

What does a response look like?

A JSON object with the matching videos and paging info:
{
  "videos": [
    {
      "id": "…",
      "title": "…",
      "description": "…",
      "tags": ["…"],
      "thumbnailUrl": "https://…",
      "isLive": false,
      "views": 0,
      "likes": 0,
      "comments": 0,
      "instance": "example.org",
      "channel": "…",
      "account": "…",
      "category": "…",
      "language": "en",
      "durationSeconds": 0,
      "publishedAt": "2025-01-01T00:00:00Z",
      "videoUrl": "https://…"
    }
  ],
  "total": 0,
  "page": 1,
  "size": 24
}
Please crawl responsibly: cache where you can and keep request rates reasonable.

Back to search