Link Recommendation API - MediaWiki

Wikimedia APIs

• Sandbox
• Access policy
• Content reuse
• Tools and bots
• Changelog

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.

• API sandbox

• Conditional requests

• Machine learning model documentation

# Get link recommendations for the Earth article on English Wikipedia
curl 'https://api.wikimedia.org/service/linkrecommendation/v1/linkrecommendations/wikipedia/en/Earth'

Try it out

See Wikimedia APIs/Access policy.

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"}'

As of March 2026, requests are subject to the global Wikimedia API limits.

See Wikimedia APIs/Stability policy.

Create an account on Wikimedia Phabricator, and tag the task with Add-Link.

Leave a comment on the discussion page.

To edit the docs, see Gerrit/Tutorial to contribute to the OpenAPI description.

See Wikimedia APIs/Changelog.