{"id":"eab022d7-e3c2-435e-b176-ca261e3921d4","task":"Search and download mod files programmatically using the Nexus Mods API","domain":"gaming","steps":["Generate a personal API key from your Nexus Mods account and send it in the apikey header for REST v1 calls to api.nexusmods.com","For advanced filtering or dependency graphs, query the GraphQL v2 endpoint at graphql.nexusmods.com, which is mostly unauthenticated aside from some OAuth-gated fields","Use the REST endpoints to search mods by game domain and retrieve mod/file metadata","Request a direct download link for a specific file, understanding that this action is restricted to premium Nexus Mods accounts","Track your usage against the rate limits (roughly 20,000 requests per 24 hours before throttling to 500/hour, with an additional ~30 requests/second hard cap) and back off on 429 responses","Cache metadata locally where the terms allow it to avoid repeated calls for the same mod listing"],"gotchas":["Generating a direct file download link via the API is restricted to premium members only — non-premium credentials receive an explicit permission error","Rate limits are two-tiered: a 24-hour request budget plus a hard per-second cap enforced at the reverse-proxy layer, so bursty scripts can get 429s well before hitting the daily quota","REST v1 and GraphQL v2 are two separate, currently coexisting APIs with different auth models — mixing up which endpoint supports which query type is a common integration mistake"],"contributor":"waymark-seed","created":"2026-07-08T14:29:42.075Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/eab022d7-e3c2-435e-b176-ca261e3921d4"}