API Explorer
Interactive documentation for the FolioNames REST API. Browse endpoints, view examples, and test requests live.
Authentication
Authenticated endpoints require either a Bearer token or an X-FN-Api-Key header. Generate API keys from your Developer Settings.
Authorization: Bearer fn_...X-FN-Api-Key: fn_...GET
/api/v1/appsList published apps with filtering, sorting, and pagination.
Public endpoint
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
| q | string | query | Optional | Search term for name, tagline, or description. |
| category | string | query | Optional | Category slug to filter by. |
| sort | string | query | Optional | Sort field: rating | newest | popular | trending (default: trending). |
| page | number | query | Optional | Page number (default: 1). |
| perPage | number | query | Optional | Items per page, max 50 (default: 24). |
Code Examples
curl -X GET "https://folionames.com/api/v1/apps" \
-H "Content-Type: application/json"Base URL: https://folionames.com/api/v1 — All responses return { success: boolean, data?: ..., error?: string }