API:Langlinks
Appearance
From mediawiki.org
This page is part of the MediaWiki Action API documentation.
MediaWiki Action API |
---|
Basics |
Authentication |
Accounts and Users |
Page Operations |
|
Search |
Developer Utilities |
Tutorials |
v · d · e |
MediaWiki version:
≥ 1.11
GET request to get a list of all interlanguage links from the provided pages to other languages.
API documentation
[edit ] The following documentation is the output of Special: ApiHelp/ query+langlinks, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).
prop=langlinks (ll)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0-or-later
Returns all interlanguage links from the given pages.
Specific parameters:
Other general parameters are available.
- llprop
Which additional properties to get for each interlanguage link:
- url
- Adds the full URL.
- langname
- Adds the localised language name (best effort). Use llinlanguagecode to control the language.
- autonym
- Adds the native language name.
- Values (separate with | or alternative): autonym, langname, url
- lllang
Only return language links with this language code.
- lltitle
Link to search for. Must be used with lllang.
- lldir
The direction in which to list.
- One of the following values: ascending, descending
- Default: ascending
- llinlanguagecode
Language code for localised language names.
- Default: en
- lllimit
How many langlinks to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- llcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- llurl
- Deprecated.
Whether to get the full URL (cannot be used with llprop).
- Type: boolean (details)
Example:
- Get interlanguage links from the page MediaWiki.
- api.php?action=query&prop=langlinks&titles=MediaWiki&redirects= [open in sandbox]
Example
[edit ]GET request
[edit ]Get a list of language links that a given page has.
Response
[edit ]{ "continue":{ "llcontinue":"736|ay", "continue":"||" }, "query":{ "pages":{ "736":{ "pageid":736, "ns":0, "title":"Albert Einstein", "langlinks":[ { "lang":"ab", "*":"\u0410\u043b\u0431\u0435\u0440\u0442 \u0415\u0438\u043d\u0448\u0442\u0435\u0438\u043d" }, { "lang":"af", "*":"Albert Einstein" }, { "lang":"als", "*":"Albert Einstein" }, ... ] } } } }
Sample code
[edit ]Python
[edit ]#!/usr/bin/python3 """ langlinks.py MediaWiki API Demos Demo of `Langlinks` module: Get a list of language links that a given page has MIT License """ importrequests S = requests.Session() URL = "https://en.wikipedia.org/w/api.php" PARAMS = { "action": "query", "titles": "Albert Einstein", "prop": "langlinks", "format": "json" } R = S.get(url=URL, params=PARAMS) DATA = R.json() print(DATA)
PHP
[edit ]<?php /* langlinks.php MediaWiki API Demos Demo of `Langlinks` module: Get a list of language links that a given page has MIT License */ $endPoint = "https://en.wikipedia.org/w/api.php"; $params = [ "action" => "query", "titles" => "Albert Einstein", "prop" => "langlinks", "format" => "json" ]; $url = $endPoint . "?" . http_build_query( $params ); $ch = curl_init( $url ); curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true ); $output = curl_exec( $ch ); curl_close( $ch ); $result = json_decode( $output, true ); var_dump( $result );
JavaScript
[edit ]/* langlinks.js MediaWiki API Demos Demo of `Langlinks` module: Get a list of language links that a given page has MIT License */ varurl="https://en.wikipedia.org/w/api.php"; varparams={ action:"query", titles:"Albert Einstein", prop:"langlinks", format:"json" }; url=url+"?origin=*"; Object.keys(params).forEach(function(key){url+="&"+key+"="+params[key];}); fetch(url) .then(function(response){returnresponse.json();}) .then(function(response){console.log(response);}) .catch(function(error){console.log(error);});
MediaWiki JS
[edit ]/* langlinks.js MediaWiki API Demos Demo of `Langlinks` module: Get a list of language links that a given page has MIT License */ varparams={ action:'query', titles:'Albert Einstein', prop:'langlinks', format:'json' }, api=newmw.Api(); api.get(params).done(function(data){ console.log(data); });
Possible errors
[edit ]Code | Info |
---|---|
invalidparammix | The title parameter may only be used with lang. |
Parameter history
[edit ]- v1.23: Introduced
llprop
,url
,langname
,autonym
,llinlanguagecode
- v1.23: Deprecated
llurl
- v1.19: Introduced
lldir
- v1.18: Introduced
lllang
,lltitle
- v1.17: Introduced
llurl
- v1.13: Introduced
lllimit
,llcontinue
See also
[edit ]- API:Links - Returns all links from the given pages.
- API:Langbacklinks - Find all pages that link to the given interlanguage link.