# FontFarsi

> FontFarsi is a free Persian/Farsi font archive with 3,490 font files, live preview, search, style filtering, sorting, shuffle browsing, and direct downloads.

FontFarsi helps designers, developers, publishers, and Persian typography users discover and download Persian, Arabic-script, and related text/display fonts. The site uses a right-to-left Persian interface, renders live previews in the selected font, and exposes public font metadata through JSON endpoints.

## Primary Pages

- [Homepage](https://fontfarsi.com/): Browse, preview, search, filter, sort, shuffle, and download fonts.
- [Search URL pattern](https://fontfarsi.com/search/Yekan): Search results for a font term; replace `Yekan` with any font name, family, filename, UID, or metadata term.
- [Direct font URL pattern](https://fontfarsi.com/Zahed_Dal): Direct font result route for a unique font name or query.

## Machine-Readable Endpoints

- [Paginated font API](https://fontfarsi.com/api/fonts): JSON list of public fonts. Supports `page`, `limit`, `sort`, `style`, and `seed`.
- [Search API](https://fontfarsi.com/api/fonts/search?q=Yekan): JSON search over font names, filenames, UIDs, and families. Supports `q`, `limit`, `sort`, `style`, and `seed`.
- [Style filter API](https://fontfarsi.com/api/fonts/styles): JSON list of normalized style filters from `ftsf`, with counts.

## Data Fields

- `id`: Integer identifier used for recent and oldest sorting.
- `fn`: Downloadable font filename.
- `ftn`: Font internal/full type name.
- `ftf`: Font family or display name.
- `ftsf`: Font subfamily/style, such as Regular, Bold, Italic, or Bold Italic.
- `uid`: Unique font identifier metadata.
- `fln`: Localized or full display label.
- `fv`: Font version metadata.
- `fcr`: Copyright or creator metadata where available.

## Usage Notes

- Search URLs and API responses are intended to be human-readable and AI-readable.
- The UI language is Persian/Farsi and the layout direction is RTL.
- Font downloads are served from the public font CDN configured by the site.
- Do not treat this file as a license document; verify individual font metadata when license certainty is required.
- Do not expose or infer private database credentials. Public APIs only expose public font metadata.

## Optional

- [Full LLM context](https://fontfarsi.com/llms-full.txt): Longer project, route, API, and response guidance for AI systems.