Link Recommendation API
|
Linking between Wikipedia articles is an important way to create connections between topics. The Link Recommendation API helps guide editors by suggesting places in an article where a link could be added.
Documentation
Reference
Guides
Concepts
Quick start
# Get link recommendations for the Earth article on English Wikipedia
curl 'https://api.wikimedia.org/service/linkrecommendation/v1/linkrecommendations/wikipedia/en/Earth'
Access policy
See Wikimedia APIs/Access policy.
Authentication
POST operations must provide an OAuth 2.0 token in the Authorization request header using the Bearer authentication scheme. To get an OAuth token, visit the consumer registration page on Meta-Wiki. For this API, we recommend creating a consumer with only basic rights. Remember to keep API tokens confidential; don't add tokens to public source control or expose tokens in user-accessible code.
# Example of a POST request using an access token
$ curl -X POST https://api.wikimedia.org/service/linkrecommendation/v1/linkrecommendations/wikipedia/en/ADD_PAGE_TITLE \
-H "Content-Type: application/json" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--data '{"pageid": 5555, "revid": 5555, "wikitext": "ADD_WIKITEXT_SOURCE"}'
Rate limits
As of March 2026, requests are subject to the global Wikimedia API limits.
Stability policy
Report a bug
Create an account on Wikimedia Phabricator, and tag the task with Add-Link.
Get help
Leave a comment on the discussion page.
Contribute
To edit the docs, see Gerrit/Tutorial to contribute to the OpenAPI description.