Wikipedia hub

Wikipedia User API

A public user record with edit count, groups and block state.

GET /v1/wikipedia/users/{name}

1 credit Failed requests are free

About this endpoint

GET /v1/wikipedia/users/Jimbo%20Wales?lang=en returns data.user for a user name on one edition. The record has userId, name, editCount, registration, groups, groupMemberships, gender, centralIds, blockId, blockReason, blockExpiry, blockedBy, blockedById and blockPartial.

groups lists the groups the user belongs to, and groupMemberships repeats them with an optional expiry. centralIds holds the central and local ids as a map. On an unblocked user the block fields are null.

A user that does not exist is lookupStatus: not_found with user: null. The name is a user name on the edition, not a profile URL, and characters such as /, \, ?, &, #, <, >, [, ], |, { and } are refused.

Wikipedia User API FAQ

Can I look up an IP address as a user?

An IP address has no user record, so the answer is not_found with user null. Use the contributions route to list an IP address's edits. User names are the names on the edition, such as Jimbo Wales or ClueBot NG.

What does a null block field mean?

The user is not currently blocked. blockId, blockReason, blockExpiry, blockedBy, blockedById and blockPartial are all null. A blocked user fills them with the block details.

Why is a user not_found?

The name does not exist on that edition. The lookup runs against the edition you pass, so a name can be found on one edition and not_found on another.

How many credits does a user lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.