{
    "name": "Free APC Journals",
    "description": "Read-only API over a directory of peer-reviewed open access journals that charge no article processing charge (APC).",
    "version": "v1",
    "documentation": "https://freeapcjournals.com/api/v1",
    "license": {
        "usage": "Free for reasonable programmatic use. Please attribute Free APC Journals when republishing."
    },
    "rate_limit": "120 requests per minute per IP. Please send a descriptive User-Agent.",
    "endpoints": {
        "GET /api/v1/journals": {
            "description": "List and filter journals.",
            "parameters": {
                "q": "Free-text search over title, alternative title, keywords and ISSN.",
                "subject": "Subject slug, e.g. \"medicine\". Includes child subjects.",
                "indexing": "Indexing database slug, e.g. \"scopus\".",
                "publisher": "Publisher slug.",
                "country": "Country slug.",
                "language": "Language slug.",
                "license": "Licence slug, e.g. \"cc-by\".",
                "sort": "One of: best, title, title_desc, newest, articles, fastest, oldest_oa",
                "page": "Page number, from 1.",
                "limit": "Results per page, 1–100 (default 20)."
            },
            "example": "https://freeapcjournals.com/api/v1/journals?subject=medicine&country=india&limit=5"
        },
        "GET /api/v1/journals/{slug}": {
            "description": "Full record for one journal, including policies, indexing and subjects.",
            "example": "https://freeapcjournals.com/api/v1/journals/{slug}"
        },
        "GET /api/v1/facets/{type}": {
            "description": "List values for a taxonomy. Type is one of: publisher, indexing, subject, country, language, license, keyword.",
            "example": "https://freeapcjournals.com/api/v1/facets/subject"
        },
        "GET /api/v1/stats": {
            "description": "Directory-wide totals.",
            "example": "https://freeapcjournals.com/api/v1/stats"
        }
    }
}