# FSE — Furry search engine

> FSE (https://fse.anthro.fr/) is a full-text search engine over 238,960 furry stories archived from SoFurry. Search results and full stories with their metadata are available as Markdown and JSON.

## Endpoints

- `GET /stories.md?q=<query>&page=<n>` — search results as a Markdown list of linked stories (12 per page, 20 pages max). Same data as JSON at `/stories.json`.
- `GET /stories/<id>.md` — a story's complete text as Markdown: title, author, tags, description, content, source URL, series navigation. Same data as `/stories/<id>.json`.
- Story ids come from search result links; both legacy numeric ids and 8-character SoFurry hashes resolve.

Examples:

- `https://fse.anthro.fr/stories.md?q=dragon+order%3Apopularity`
- `https://fse.anthro.fr/stories.md?q=tag%3Afriendship+words%3A%3E5000+rating%3As`

## Query language

- `some terms` — all words must appear, in metadata or content
- `"some terms"` or `some_terms` — exact phrase
- `cat OR dog`, `cat | dog`, `~cat ~dog` — any of these words (OR)
- `dragon*` — prefix match
- `-term` — exclusion; parentheses group as expected
- `tag:term`, `author:name`, `title:term`, `content:term` — field match
- `words:>5000`, `words:<1000` — story length
- `date:2024`, `after:2024-03`, `before:2024`, `since:2024` — posting date
- `rating:s` — safe-for-work only; `rating:e` — explicit only
- `order:date`, `order:date_asc`, `order:words`, `order:views`, `order:likes`, `order:popularity`, `order:random` — default is relevance
- `violence:false` — content filter

## Notes

- Most of the corpus is adult furry fiction (`rating:e`); use `rating:s` to restrict to safe-for-work stories.
- Every story links its original `sofurry.com` source; please attribute stories to their authors.
- Human-readable search syntax reference: https://fse.anthro.fr/help