Wikipedia / MediaWiki · Rate Limits

Wikipedia Rate Limits

Wikimedia projects have no hard published per-second number for the Action API or REST APIs, but publish a clear etiquette: serial (not parallel) requests, a contactable User-Agent header, use of maxlag for non-interactive jobs, and exponential backoff on the ratelimited error code. The cached REST API v1 documents a soft 200 requests/s ceiling per client. The Wikidata SPARQL endpoint enforces 60s per query and 5 concurrent queries per IP. Wikimedia Enterprise applies per-account QPS and throughput limits with the actual numbers documented per-plan.

Wikipedia Rate Limits is the machine-readable rate-limit profile for Wikipedia / MediaWiki on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 9 rate-limit definitions, measuring requests_per_second, varies, seconds, concurrent_requests, and requests_per_month.

The profile also includes 6 backoff/retry policies defined and response codes documented for throttled, rateLimited, serverBusy, and queryTimeout.

Tagged areas include Rate Limiting, Open Knowledge, Encyclopedia, Knowledge Graph, and Enterprise.

9 Limits Throttle: 429
Rate LimitingOpen KnowledgeEncyclopediaKnowledge GraphEnterprise

Limits

REST API v1 - cached anonymous reads client
requests_per_second · second
200
Soft per-client cap documented in the REST API v1 OpenAPI description. Heavily Varnish-cached so the limit applies primarily to cold paths.
Action API - read operations client
requests_per_second
serial (one in flight)
No hard speed limit; Wikimedia explicitly asks clients to issue requests serially rather than in parallel. Use generators and pipe-separated batches to reduce round-trips.
Action API - write operations account/right
varies
see action=query&meta=userinfo&uiprop=ratelimits
Per-user-right rate limits enforced server-side. Returns `ratelimited` error code; retry with exponential backoff and increased delays.
Wikidata SPARQL - query execution time client/query
seconds · second
60
Queries exceeding 60s wall-clock are killed and return 503.
Wikidata SPARQL - concurrent queries IP
concurrent_requests
5
Per-IP concurrency cap on query.wikidata.org.
Wikimedia Enterprise Free - Snapshot account
requests_per_month · month
15
Free developer plan ceiling. Bumped to unlimited on paid plans.
Wikimedia Enterprise Free - Snapshot chunks account
chunks_per_month · month
1500
Free developer plan ceiling.
Wikimedia Enterprise Free - On-demand account
requests_per_month · month
5000
Free developer plan ceiling. Bumped to unlimited on paid plans.
Wikimedia Enterprise Paid - QPS account
requests_per_second
plan-specific
All accounts face QPS and throughput limits; the exact numbers depend on the negotiated paid plan.

Policies

Contactable User-Agent
Every request must include a meaningful User-Agent header of the form "clientname/version (contact: email or URL) framework/version". Requests without an identifiable User-Agent may be blocked at any time without warning.
Use maxlag for non-interactive jobs
Pass maxlag=5 (or similar) on bot / batch traffic so MediaWiki returns 'maxlag exceeded' rather than running during replication backlog. Treat the maxlag response as a signal to pause for several seconds.
Serial requests preferred
Issue read requests one at a time. Batch multiple titles into a single call using the pipe character (titles=A|B|C) and use list/generator queries to avoid sequential calls.
Exponential backoff on ratelimited
When the Action API returns errorcode=ratelimited or the REST APIs return HTTP 429, retry with exponential backoff and longer delays between attempts. Honour Retry-After if present.
Cache and prefer GET
Prefer GET (cacheable) over POST for read operations. Cache responses locally and honour smaxage/maxage parameters. Send Accept-Encoding: gzip.
SPARQL graph split for heavy workloads
For Wikidata SPARQL workloads, use the scholarly / non-scholarly endpoint split (query-scholarly.wikidata.org, query-main.wikidata.org) to avoid contention on the full query.wikidata.org endpoint.

Sources

Work with this as data

Every rate limit here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for rate limits

4 MCP tools reach this
  • find_rate_limitsBrowse and filter every rate limit in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This rate limit 
curl "https://apis.io/api/v1/rate-limits/wikipedia-rate-limits"
All rate limits 
curl "https://apis.io/api/v1/rate-limits?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.