Evidence, in a format
your tools can use.
Base URL: https://findthefactory.com
Download the OpenAPI schema · MCP integration guide
Authentication
Public search returns previews. Supply a revocable account API key or OAuth access token as Authorization: Bearer TOKEN for account-level access. Unlock requires an explicit POST and shares the single free search across clients. Paid access expires with the purchased term.
curl 'https://findthefactory.com/api/v1/search?q=Covered' \ -H 'Authorization: Bearer YOUR_FTF_KEY'
Endpoints
GET /api/v1/search
Api Search
q — query
category — query
POST /api/v1/unlock
Api Unlock
Send JSON. See the linked OpenAPI schema for the exact request model.
GET /api/v1/organisations/{organisation_id}/portfolio
Api Portfolio
organisation_id — path, required
GET /api/v1/export
Export
q — query, required
category — query
POST /api/v1/watches
Api Watch
Send JSON. See the linked OpenAPI schema for the exact request model.
Response limits and errors
Search returns at most 20 assertion rows; a free unlock returns at most five frozen rows. Results include coverage and truncation notes. 401 requires authentication, 402 requires an entitlement, 422 indicates invalid input, and 429 indicates a quota/rate limit. Private responses use Cache-Control: no-store.