Skip to main content

API Docs

Interactive documentation for the FolioNames REST API. Browse endpoints, view code examples, and test requests live.

Authentication

Most endpoints are public. Authenticated endpoints use the session cookie set when you sign in on this site, so they work from your signed-in browser, including the Send button on this page. There are no bearer tokens for signed-in users, and developer API keys (X-FN-Api-Key) are not being issued at the moment.

Most public endpoints are rate-limited per IP address, and any limited endpoint can return a 429. /apps and /search also send X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset with your real remaining budget.

GET/api/v1/apps

Returns a paginated list of published AI tools with their AI facts and provenance. Supports cursor pagination, category and pricing filters, the browse facets (models, modalities, training stance, sign-up, price ceiling, API) and sort ordering. Rate-limited per IP; X-RateLimit-* headers report your real remaining budget.

Public endpoint

Parameters

NameTypeInRequiredDescription
querystringqueryOptionalFree-text search.
cursorstringqueryOptional
perPagenumberqueryOptional
categorystringqueryOptionalCategory slug.
pricingModelstringqueryOptionalLegacy: FREE, FREEMIUM, PAID, SUBSCRIPTION, OPEN_SOURCE or UNKNOWN.
pricingstringqueryOptionalOne of free-to-try (a free plan, free credits or a trial), free, freemium, paid, subscription, open_source.
maxPricenumberqueryOptionalPrice ceiling in pounds a month: 10, 20, 50 or 100. Only tools that state a starting price match.
formatstringqueryOptionalWEB_APP, WEB_PAGE or AI_AGENT.
inputstringqueryOptionalWorks with these modalities (text, image, audio, video, code, file, data, 3d). Repeat the param or comma-separate; tools must match ALL of them.
outputstringqueryOptionalCreates these modalities — same values and rules as `input`.
modelstringqueryOptionalAn AI model the tool lists, exactly as listed (e.g. GPT-4o).
trainingstringqueryOptionalno-training (only listings whose facts an editor or the maker has checked) or opt-out.
signupstringqueryOptionalnot-required or required (whether you need an account to use it).
apibooleanqueryOptional1 or true: only tools with a public API.
maturitystringqueryOptional
minRatingnumberqueryOptional
isPWAbooleanqueryOptional
isOpenSourcebooleanqueryOptional
sortBystringqueryOptional
sortOrderstringqueryOptional

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 }