API talk:Main page

From MediaWiki.org
Jump to: navigation, search
An archive box
General Archive


Navigate in a mediawiki content from another site ?[edit]


With a group of friends we are working a mediawiki platform to share content about design. Maybe can API users give us some advices ?

We are trying to make other sites able to build them own navigator in our content.

The advantage for the users of theses site is that they could have personalised acces to content that they were looking on the site they were. The advantage to the wiki is to make a better participation through "edit" links on other site that come back to the wiki in edit mode.

After 2 days of researches on the web I found :

Yet I can't manage to use the extracted content. It only prints a layout of the html code, not interpretating it.

If you can help us it would be super !

Thanks !

--Thibho 16:00, 28 June 2009 (UTC)

Some news, a friend told me that it would be better to use xml layout : http://en.design-platform.org/api.php?action=parse&page=Brand&format=xml . Then we would have to build a script to extract content in the "text" balise, to tranform links and to build a lik that redirect on the wiki in edit mode. This is out of my abilities so I continue my researches looking if can find examples to start it. --Thibho 17:17, 28 June 2009 (UTC)

So the solutions we use are :

Option 1 : Using iframes
This integrate a minimaliste skin of the wiki in the site with an iframe.
This solution provides the way to keep integrated style skin up-to-date since only a minimalistic part of the wiki is integrated and the rest can be managed by the site owner.
<iframe src ="http://for-iframes.wikidomaine.com">
  <p>Your browser does not support iframes.</p>
In the wiki localsettings.php :
switch ($_SERVER["SERVER_NAME"])
        case "for-iframes.wikidomaine.com":
                $wgDefaultSkin = "minimalist_skin";
                $wgAllowUserSkin = false;

                $wgDefaultSkin = "wiki_original_skin";
The main problem of this is that the users cannot copy/past the url since it is always the same. We are looking for a solution for this aspect.

Option 2 : feel and tast with a full site-like skin and same menu
This use the same type of swich as precedently but with a full skin and copuing the site menu.
This solution can be simpler if there is only one partner site or if you create a skin template that can be easily modified for each site.

There is also many solutions based on scripts, page re-writting, API, etc... wich have the advantage to be managed entirely by the partner site but that require more expetise from the site webmaster.

Thanks !

--Thibho 21:15, 7 July 2009 (UTC)

Protected pages[edit]

Hi. I have another request... would it be possible to add & protected or something similar to retrieve the list of protected articles? I could not find any other way (other than downloading page.sql) for doing so. Thanks! Paolo Liberatore 12:46, 3 October 2006 (UTC)

I am not sure the list of protected articles is available from the database. If it is, I can certainly expose it. --Yurik 16:24, 3 October 2006 (UTC)
That would be great! Thank you. Paolo Liberatore 16:16, 10 October 2006 (UTC)
As an alternative that could be possibly be simpler to implement, the entire record of an article from the page table could be retrived via prop=info. Paolo Liberatore 17:52, 6 November 2006 (UTC)
I just noticed there is a page_restrictions field in the page table. I will have to find out what it might contain (the Page table is not being very descriptive, and afterwards add that to prop=info. Filtering by that field is problematic because its a tiny blob (i don't think mysql can handle blob indexing, but i might be wrong). --Yurik 22:31, 6 November 2006 (UTC)
Here is my reading of the source code. The point where page_restrictions is interpreted is Title.php. There, loadRestrictions reads this field, parses it and stores the result in the mRestricions array. This array is then used by getRestrictions to return an arrary containing the groups that are allowed to perform a given action. As far as I can see, this array is such that mRestrictions['edit'] is an array that contains the groups that are allowed to perform the edit action, etc. Except that, if this array is empty, no restriction (other than default ones) apply.
In the database dump, the page_restrictions field appears to be either empty or something like edit=autoconfirmed:move=sysop or just sysop. The explanation of the table says that this is a comma-separated list, but the comments in Title.php mention that is an old format (I think that the value 'sysop' is actually in this format; no page in wikien current has a comma in the page_restrictions field). Paolo Liberatore 15:52, 11 November 2006 (UTC)


Are there any plans to provide raw diffs between revisions? This would be particularly helpful for vandalism fighting bots who check text changes for specific keywords and other patterns. The advantage would be that diffs require much less bandwidth and therefore increase bot response time. What do you think? Sebmol 15:24, 21 November 2006 (UTC)


Would it be possible to add an option which woud simply return the number of articles which satisfied the supplied conditions? This would be especially helpful counting large categories, like en:Category:Living people. HTH HAND —Phil | Talk 15:59, 29 November 2006 (UTC)

I second that emotion. Zocky 23:26, 9 December 2006 (UTC)
Unfortunately this is harder than it looks - issuing a count(*) against database if the client asks for list=allpages would grind db to a halt :). Same goes for list of all revisions, user contribution counters (we even had to introduce an extra db field to keep that number instead of counting), etc. So no plans for now, unless some other alternative is given. --Yurik 09:41, 8 July 2007 (UTC)

version/image info[edit]

I think it would be useful to get information about the sofware version (i.e. core version, extensions, hooks/functions installed) and images (i.e. checksum would useful to see if an image has changed). -Sanbeg 21:08, 7 December 2006 (UTC)

Some of it is available through the siteinfo request. More will be done later. --Yurik 01:59, 22 May 2007 (UTC)

Select category members by timestamp[edit]

Hello, is it possible to retrieve cm with a parameter that lists only starting from a certain timestamp? This should be possible, since a timestamp is stored in the categorylinks database table. Is this the correct place to ask, or should I file a bug in bugzilla? Bryan 12:18, 24 December 2006 (UTC)

Similarly get all templated embedding pages by timestamp would be useful for monitoring when a template gets used because it contains structured data that can be reflected on other websites. 15:14, 9 February 2007 (UTC)
Not sure what you mean. Please file a feature req in bugzilla with the sample request/response. --Yurik 09:43, 8 July 2007 (UTC)

mw-plusminus data[edit]

MediaWiki recently add mw-plusminus tags to Special:Recentchanges and Special:Watchlist, which display the number of characters added/removed by the edit. I was wondering if it may be possible for api.php to both retrieve this info and somehow append the data to query requests that involve page histories, recentchanges, etc. I would most like to see this available in usercontribs queries, as that data is currently not retrievable through any other medium (save for pulling up each edit one at a time and compaing the added/removed chars). Thanks. AmiDaniel 23:55, 26 February 2007 (UTC)

Done for rc & wl. --Yurik 20:09, 8 July 2007 (UTC)

Query Limits[edit]

Hi all, another suggestion from me. On the API it is stated that the query limit of 500 items is waived for bot-flagged accounts to the MediaWiki max query of 5000. Would it be possible to extend this same waiver to logged-in admin accounts? I have multiple instances in some of my more recent scripts that query, quite literally, thousands of items (backlinks, contribs, etc.) that are primarily only used by myself and other administrators on enwiki. While having to break these queries up into units of 500 causes a rather dramatic performance decrease on the user's end, I can't imagine it's particularly friendly on the servers either (or rather, submitting two or three requests of 5000 each would likely be less harmful to the servers than twenty or thirty requests of 500 each). Generally, admins are considered similarly well-trusted not to abuse such abilities, and they are also small in numbers on all projects. Also, the MediaWiki software itself allows similar queries of upto 5000, and I most presume that loading this data from MediaWiki is far more burdenous on the servers than submitting the same query through API. This clearly more a political matter than a technical one, but I'd like to know if there are any objections to implementing such a change. Thanks. AmiDaniel 05:05, 1 March 2007 (UTC)

done. By amidaniel. :) --Yurik 05:58, 17 July 2007 (UTC)

partial content[edit]

it is great to be able to retrieve wikipedias content by an API, but nobody is really going to need the whole page.

would it be possible to pass a variable which adds only the lead paragraph (everything before the TOC) to the XML, not the whole content ? This would be ideal for an implementation into another context, then adding a "View Full Article" link underneath.

any chance of this becoming a possibility ?-- 00:49, 19 March 2007 (UTC)

I'd also consider useful to be able to retrieve a single section from the article, so that one could first load the article lead and the TOC, and then see only some of the section(s). This would be a great improvement of efficiency especially for people on slow links (e.g., mobile) and for "community" pages, such as en:Wikipedia:Administrator's noticeboard, some of which tend to be very long. Tizio 15:19, 20 March 2007 (UTC)

returning the beginning/end of a document[edit]

Is there any possibility of an API function that returns the first x bytes at the beginning or end of a document? An increasing amount of metadata is stored at the beginning or end of wikipedia articles, talk pages, etc. And tools like "popups" that preview pages don't need to transmit the whole document to preview part of it. I am thinking of client, server, and bandwidth efficiency. Outriggr 01:43, 20 April 2007 (UTC)

Current status ?[edit]


I have started developping a tool in Java to deal with some maintenance tasks, especially for the disambiguation pages. For the moment, I have planned to do two parts :

  • Much like CorHomo, a way to find and fix all articles linking to a given disambiguation page.
  • A way to find and fix all links to disambiguation pages in a given article.

To finish my tool, I need a few things done in the API :

  • Retrieving the list of links from an article.
  • Submitting a new version of an article.

Do you have any idea when these features will be available in the API ?

How can I help ? (I am rather a beginner in PHP, I have just developped a MediaWiki extension, here, but I can learn).

--NicoV 13:24, 23 April 2007 (UTC)

For your "Retrieving the list of links from an article" problem, check the query.php what=links query. It's already been implemented, just not brought over into api.php. As for submitting a new version of an article, I'm afraid there is no ETA on this, and I'm honestly not sure how Yurik is going to about doing this. For now, I'd recommend you do it as it's been done for years--submitting an edit page with "POST". It's not the greatest solution, but it works. If you'd like to help, please write to w:User_talk:Yurik; I'm sure your help is needed! AmiDaniel 18:10, 23 April 2007 (UTC)
Thanks for the answer. I was hoping to use a unique API, but no problem in using query.php for the links. For submitting a new version, do you know where I can find an example of submitting an edit page ? --NicoV 20:33, 23 April 2007 (UTC)
Unfortunately, dealing with forms and especially MediaWiki forms (as submitting all forms requires fetching userdata from cookies typically) in Java is not particularly easy. For a basic example in submitting a form in Java, see this IBM example. For most of the stuff I've developed, instead of trying to construct my own HttpClient and handle cookies myself, I've simply hooked into the DOM of a web browser and let it take care of the nitty gritty of sending the POST's and GET's. You can see an example of this method using IE's DOM here. I've not found a good way to get the latter to work with Java as Java does not have very good ActiveX/COM support, though it can sort of be done by launching a separate browser instance. I'm afraid I can't really help much more, unfortunately, as it's a problem that's not been well-solved by anyone. It's easy to build MediaWiki crawler's, but not so easy to build bots that actually interact with MediaWiki. AmiDaniel 21:20, 23 April 2007 (UTC)
A en-wiki user has written something for page editing in java: en:User:MER-C/Wiki.java. HTH. Tizio 13:10, 26 April 2007 (UTC)
I have used parts of the java class you linked, and it's working :) Thanks --NicoV 07:57, 22 May 2007 (UTC)

Ok, thanks. I will take a closer look at the examples. --NicoV 05:38, 27 April 2007 (UTC)

Some have been done (links, etc). See the main page. --Yurik 11:48, 14 May 2007 (UTC)
Thanks, I will try to use it when it's available on the French Wikipedia --NicoV 20:28, 14 May 2007 (UTC)

Hi, I've also started a Java API (see my blog entry: Java API for MediaWiki query API, I'd like to here opinions about the design and usability of the library. Thanks Axelclk 17:57, 22 June 2007 (UTC)

Real current status[edit]

Could somebody please tell the current status of the api regarding fetching a list of links from a site via api.php?query&titles=Albert%20Einstein&prop=links ?

This works just fine with the latest mediawiki on wikipedia but on my mediawiki v1.10 it dont work at all. error reported: unknown_prop. I investigated some time and recognized that there is no includes/api/ApiQueryLinks.php in 1.10. The import of the module also is commented out in ApiQuery.php, like this:

  private $mQueryListModules = array (
     'info' => 'ApiQueryInfo',
     'revisions' => 'ApiQueryRevisions'
  // 'links' => 'ApiQueryLinks'
  // ...some other modules as well

So, what's going on? On API:Query - Page Info it is stated that the link fetch feature is available with MW 1.9. I am confused...

So am I :) From what I remember, it has been working for a long time. There is a new release coming out shortly, that will include all the proper changes. As for now, I would suggest simply copying the entire API directory from the current SVN - API would not mess up anything, so if worst comes to worst, it will simply not work :) --Yurik 21:37, 13 July 2007 (UTC)
Unfortunatly, this didn't work for me. I checked out the latest trunk/phase3/api. After moving it into includes, nothing works at all :( The PHP engine stated: Fatal error: Call to undefined function wfScript() in /srv/www/vhosts/wikit/htdocs/mediawiki-1.10.0/includes/api/ApiFormatBase.php on line 88. So, I thought to try to get just the class ApiQueryLinks to work with the 1.10.0 api-code and included the class in ApiQuery. After that I tried to call the api. But it seems like the ApiQueryGeneratorBase-class cant be found anywhere. Hopefully the api will work again with one of stable releases to come... --Bell 09:09, 16 July 2007 (UTC)

Hi,you coul try to run 'unstable' vrsion - I actually found it to be reasonably stable. Just sync it from the svn and run updata.php to get the databases up to date. Also, the 10.1 is out. --Yurik 06:07, 17 July 2007 (UTC)


I, personally, don't understand why state-changing actions currently require tokens. Shouldn't the lg* parameters be enough to determine whether the client is allowed to perform a certain action? If so, why do you need tokens?

On a side note, I intend to start writing a PHP-based bot using this API, and will try to include every feature the API offers. Since both this talk page and its parent page have been quiet for two weeks, I was wondering if new API features are still posted here. If that is the case, I'll monitor this page and add new features to my (still to be coded) bot when they appear. I'll keep you informed on my progress. --Catrope 17:20, 9 May 2007 (UTC)

The motivation for tokens at Manual:Edit token is that they are used to prevent session hijacking. Tizio 19:02, 15 May 2007 (UTC)
Ah, I understand now. Didn't think it through as deeply as you did. --Catrope 20:19, 22 May 2007 (UTC)
Would it be possible to at least grab editing tokens by API, and require session data, cookie tokens, etc. to get them? The same can be done with index.php (if not mixed up in a lot of other HTML). Gracenotes 17:04, 4 June 2007 (UTC)

Login not working ?[edit]

Hi, is there a problem with the "login" action? Whenever I try (in the last hour), I get the following message:

<error code="unknown_action" info="Unrecognised value for parameter 'action'">

-- NicoV 20:57, 21 May 2007 (UTC)

Yes, unfortunately I had to disable login action until a more secure solution is implemented. The current implementation allowed countless login attempts, allowing crackers to break weak passwords by brute force. Disabling it was the only solution. Any help with fixing login module would be greatly appreciated and bring it back faster. --Yurik 01:58, 22 May 2007 (UTC)
Would it be possible while disabling it to return an understandable message, like result=Illegal or an other value like result=LoginDisabled ? Currently, when asking XML result, the result is not XML. My tool wasn't prepared for this :). That way, when I get this answer, I would be able to validate the login using an other method (by going through the Special:Login page).
Concerning help, I am not very good at PHP, so I doubt I can help you much. I suppose simple tricks like delaying the answer of the login action wouldn't be sufficient. --NicoV 07:17, 22 May 2007 (UTC)
The format is obviously not handled properly - even if everything else fails, proper format should be used. Please file as a bug. Thanks for the logindisabled suggestion - I might implement something along those lines later. Now, if only someone could help with the login php code :) Its not hard, just annoying :( --Yurik 21:07, 22 May 2007 (UTC)

I just sent a patch of to Yurik that fixes these security vulnerabilities (the big one that Yurik mentioned at least) and re-enables the login, so this will hopefully make it in the repo by tomorrow and will be synced up on Wikimedia's servers within the week. Sorry for the inconvenience. AmiDaniel 10:36, 23 May 2007 (UTC)

That's great news, but in the mean time, the Special:Login page has just been modified with a capcha (at least on the French wikipedia). So the method I was using to edit pages is not working any more :( Is there a way to edit pages with a tool ? --NicoV 15:30, 23 May 2007 (UTC)


Limits on some queries (like logevents) is lower than allowed via common MW interface. - VasilievVV 15:34, 29 May 2007 (UTC)

RC (list=recentchanges) also has this problem. api.php limits it to 500, but I can get up to 5000 using the regular interface. --Catrope 15:37, 29 May 2007 (UTC)
This has recently been changed to allow the limit of 5000 and 50 to fast and slow queries, respectively, to sysops as well as bots. We're hesitant enabling higher limits to non-sysops and non-bots, however, until we can do some serious efficiency testing with the interface. AmiDaniel 08:35, 1 June 2007 (UTC)
Why is it necessary to make different limits for bots and normal users? They have equal limits in UI (5000). So I think it would be better to set 5000 limit to all queries, that doesn't read page content - VasilievVV 08:38, 2 June 2007 (UTC)

Bad title error[edit]

Compare the result of the following two queries:


In the latter query, the second title is empty (and thus invalid), which causes the API (to rightfully) throw an error. The downside is that it destroys my entire query (the original query that caused my error here contained 500 titles, of which one was empty). This is pretty unfriendly behavior, but fixing this raises the issue of having to return an error and a query result in one response (which is currently impossible).

Alternatively, I can make sure there are no empty titles in my query (which fixed my problem), but are empty titles the only ones that trigger the "invalid query" error? If not, could someone provide a list of exactly what causes api.php to return "invalid query"?

Thanks in advance --Catrope 15:32, 5 June 2007 (UTC)

  • This problem still exists. The same thing happens if there is a bad title as opposed to an empty title; example: this query just returns a "bad title" error but doesn't tell you which one of the titles caused the error, and doesn't return any information about the titles that are OK. --Russ Blau 14:26, 18 September 2007 (UTC)
Thanks. Is there a bug filed for this? --Yurik 17:28, 18 September 2007 (UTC)

Searching content?[edit]

There's a comment from 2006 in the General Archive above that says:

  • list of articles that contain string query

Is this being implemented in the API? -- SatyrTN 21:55, 7 June 2007 (UTC)

A feature like this would be essential for search-and-replace bots. --Catrope 07:40, 8 June 2007 (UTC)
So would that be a "yes"? :) -- SatyrTN 14:02, 13 June 2007 (UTC)
I have no idea if it's going to be implemented or not, I'm not in charge of developing the API. I was just saying that it's very useful, and should be implemented.--Catrope 15:29, 13 June 2007 (UTC)
I agree that it would be an excellent feature to have. My biggest concern at the present though is the ability to unit test the API: we are in dire need to have good testing framework before we move forward. --Yurik 01:11, 14 June 2007 (UTC)
What sort of framework, exactly, are you thinking of? There is a lot of bot code around that might be a starting point. CBM 02:51, 14 June 2007 (UTC)

Page watched ?[edit]

With the API, is there a way to know if a page is watched by the user ?

That would be useful for me: I have written a tool to help fixing links to disambiguation pages, and currently when the tool submits a new version of a page, the page is always unwatched. I can probably deal with this, but that would mean reading a lot more from Wikipedia, because the "wpWatchthis" checkbox is far from the begining of the page. --NicoV 21:12, 8 June 2007 (UTC)

You don't need the checkbox, the buttons right on top of the page are enough. There will be a "watch" button if the page isn't watched, and an "unwatch" button if it is. Of course when editing pages is implemented in the API, you'll no longer need all of this. --Catrope 08:47, 11 June 2007 (UTC)
Yes, thanks. The only drawback seems the waste of bandwidth (the watch button is almost at the end of the HTML file, while the checkbox is earlier, and a lot earlier on the French wikipedia because a lot of automatic stuff is added in between). I have already tested with the checkbox, but it doesn't work how I'd like it to for users having a preference of automatically watching pages they are editing. I will try the Watch button. --NicoV 21:39, 12 June 2007 (UTC)
Hmm, maybe request the watchlist (through the API) at the beginning of your program, then check every page title against that list? --Catrope 12:57, 13 June 2007 (UTC)
Thanks again, but I have decided to use the "watch"/"unwatch" button, until (I hope) there's a way of getting this info when retrieving page data through the API. --NicoV 17:40, 14 June 2007 (UTC)
You really don't need to. With two requests to the API (one to log in and one to get your watchlist through action=query&list=watchlist) you can store your watchlist in an array. When editing a page, simply check if it's in the array. --Catrope 19:42, 14 June 2007 (UTC)


I know very little about programming and computers, but this API thing sounds like it could be used to get useful data such as a list of biographical articles without DEFAULTSORT keys. Am I right to think that a query could be run that could detect all articles with w:Template:WPBiography on their talk pages, but which didn't have the DEFAULTSORT magic word somewhere in the article, and furthermore that the categories (cl) function with "Parameters: clprop=sortkey (optional)" could detect existing pipe-sorting in the categories and output that data as well? Or am I misunderstanding the purpose and limits of API? Carcharoth 10:16, 18 June 2007 (UTC)

It's possible, but:
  • The API can list articles with a certain template in them or all articles in a certain category, but it can't search through them. You'll have to write a script that does that.
  • That script could distinguish DEFAULTSORT, pipe-sorted and non-sorted articles, but it can't automatically correct them to use the DEFAULTSORT magic. You'll have to do that by hand.
I'll write that script some time this week (as the DEFAULTSORT issue is present on BattlestarWiki as well), so keep an eye on this page to see when it's there. --Catrope 15:06, 18 June 2007 (UTC)

Feature request : list=random[edit]

Let the API generate a list of random pages as the list. Parameters:

  • Namespace(s)
  • Redirect filter
  • Limit

Would be useful for tools that look for pages/images matching criteria that are not easily obtained otherwise, e.g., pages with no (trivial) categories. --Magnus Manske 23:51, 23 June 2007 (UTC)

Future edit API[edit]

I think that when the edit functionality is to be implemented, it should be defined as POST, and not GET. AzaToth 23:43, 24 June 2007 (UTC)

I think it shouldn't deny either kind of request as both have their uses. It's the names and values contained in the requests that should determine the functionality, not the kind of request. --Nad 04:13, 25 June 2007 (UTC)
nah, there's a reason for GET and POST to be different HTTP-verbs. one to get information from the server, one to change information on the server. btw, login should never work with GET, you don't want your password in the server logs. -- D 12:02, 25 June 2007 (UTC)
GET and POST are allowed for all API requests, and there is no easy way to change that for just one action. IMO, users who are stupid enough to send a GET request with their password or other sensitive stuff should bear the consequences. BTW, action=edit users will be forced to use POST in most cases, since the query string supplied with GET is limited to 255 characters, while most articles are substantially longer. In fact, the longest Wikipedia article comes close to being 450KB in size. --Catrope 18:11, 26 June 2007 (UTC)

API Interface for .NET[edit]

I've been putting together an Open Source .NET interface for the MedaiWIKI API, I've looked around the site for where to list it, but haven't found anything that looks like the right place, can anyone point me in the right direction as to where? 02:15, 1 July 2007 (UTC)

I have made something similar a while back, but haven't published it. Not sure if mediawiki would want to keep this, but you could always add it to sourceforge. --Yurik 03:42, 2 July 2007 (UTC)
Yeah not a big deal, currently have it on google hosting maybe i'll move it. Thanks 21:43, 2 July 2007 (UTC)
It seems there is no sources there? Where the sources or library could be downloaded? uk:User:Alex_Blokha
On http://sourceforge.net/projects/jwbf/ you can find a API Interface for Java, what are you thinking about a list of projects which supply connectors to MediaWiki API ?
Will create a page for them, thanks for the link. Please sign your posts with --~~~~. --Yurik 18:49, 8 July 2007 (UTC)

Why there is no wsdl?[edit]

Why you do not release wsdl api? http://www.google.com/search?hl=uk&q=define:wsdl Why should we write for each platform/language new wrapper, instead of just using wsdl, which is implemented and tested on each platform? For example on .net platform, wsdl serice is included in project with 3 clicks of mouse. uk:User:Alex_Blokha

WSDL is just for web services, whereas we have simple HTTP get/post request-response protocol to allow many different clients to seamlessly use our API. A WSDL wrapper might be useful, and could be added at a later date. Feel free to contribute. --Yurik 04:02, 17 July 2007 (UTC)
I don't program with php. The only thing I know about it, that wsdl support is included in last versions of php. But if you can give windows web-hosting, the web-service based on existing frameworks for wikipedia can be created. By me for example. uk:User:Alex_Blokha
Although the MediaWiki API is written in PHP, its output is still XML by default. You can change that to JSON, PHP, and some other formats by setting the format= parameter. --Catrope 14:32, 1 August 2007 (UTC)


why doesn't imageinfo use a list for the image revisions? using stringified numbers as keys to a map is a bit strange, especially the extra "repository"-entry makes it a bit hard to parse. within the revision, "size", "width" and "height" look very much like numbers to me, so why are these strings, too? -- 23:42, 6 August 2007 (UTC)

Fixed the size values. Not sure how to implement the list yet (need to move rep name somewhere else). --Yurik 03:34, 7 August 2007 (UTC)
oh, very nice, thank you :) i guess the repository is not fixed easily, pushing down the revisions one level would be a bit incoherent.. -- 08:13, 7 August 2007 (UTC)
I fixed this by adding page-level tag "imagerepository". --Yurik 08:45, 9 August 2007 (UTC)
thanks again :) -- 12:46, 10 August 2007 (UTC)


is there a reason list=exturlusage contains a "p"-tag instead of an "eu" as i would expect? -- 00:58, 8 August 2007 (UTC)

Thx, fixed. --Yurik 08:44, 9 August 2007 (UTC)


Yurik, I posted this on your enwiki talk page, then realized that this might be a better venue.

I was wondering if you (or any other API users) would be interested in reviewing an API query module I've cooked up, to see if it'd be worthy of a commit. It's basically a clone of ApiQueryAllpages, except it implements Special:Protectedpages instead of Special:Allpages, removing the need for bot developers to either screen-scrape Special:Protectedpages for a list of protected pages, loop through QueryLogevents, or run QueryAllpages through QueryInfo for protection information.

Perhaps it'd be better implemented by extending an existing module? Let me know what you think.  :) — madman bum and angel 07:08, 8 August 2007 (UTC)


I added this to the list=allpages - makes more sense there. Hope it does not ruin db performance. --Yurik 08:43, 9 August 2007 (UTC)
Thanks! I shouldn't think it would, but I'll watch it carefully. If it does, then I suppose we can switch limits for that query to the slow query limits. Madman 16:18, 9 August 2007 (UTC)
Unfortunately it is not the number of items that takes long time, it's the query itself. Will monitor it later on. --Yurik 05:28, 13 August 2007 (UTC)


hi! the documentation says

 rvlimit        - limit how many revisions will be returned (enum)
                  No more than 50 (500 for bots) allowed.

this seems not to be true: when logged in, i can get 500 revisions without having the bot flag set. -- 12:46, 10 August 2007 (UTC)

I think administrators have the same limits of bots. Tizio 16:14, 14 August 2007 (UTC)

result-less lists[edit]

another thing that bugs me: getting f.e. list=backlinks to a page with zero links to it, i get


back. i'd expect

{ "query": 
  { "backlinks": 
    [] } } 

instead. the same goes for format=xml where i get a simple <api /> and many other places than just list=backlinks -- 18:16, 11 August 2007 (UTC)

Please file a bug with a sample query url. --Yurik 05:27, 13 August 2007 (UTC)
I filed a similar bug (bug 10887) Bryan Tong Minh 21:35, 14 August 2007 (UTC)

Post/edit data[edit]

Posting data via the api isn't possible at this time. So, which other method can be used for it right now? It seems like there are some alternatives:

  • post form data via http
  • post data via mediawikis xml-import interface
  • use one of the bot frameworks, that capsulate that job, so we don't have to think further

But there aren't any PHP bot frameworks right now. Does anybody have implemented posting data via php yet? If so, please link/post your solution. thanks!

I'm new to http programming, so forgive me if I'm misunderstanding your question. You can use index.php for writing a page. I have some java code which does that (and more that is specific to my bot) aten:User:WatchlistBot/source.java the writing is in Page.java, in the put() method. I got started using en:User:Gracenotes/Java_code which is much less code and shows how to read/write pages. Mom2jandk 20:23, 28 August 2007 (UTC)
Extension:Simple Forms allows editing/creating of articles from URL, but doesn't use edit-tokens. Once API supports editing, SimpleForms would use that in preference to it's own methods, but for now it is a working PHP way of editing articles. --Nad 21:03, 28 August 2007 (UTC)

How to find API URL?[edit]

Let's say I'm creating some tools that get information (via the API) off a wiki specified by the user.

So the tools need the API's URL, but how does the user know the URL of the API? For example, on Wikipedia mod rewrite is used to give pretty URLs so the API is avalaible at http://en.wikipedia.org/w/api.php. We know it is there because we are interested in that kind of thing and read medaiwiki.org, but if my tools asked the user for the URL of the wiki's API, I think it is unlikely they would have known to use this address.

Is there a specified pattern to where the non-modrewrite versions of the URLs go in a wiki, or is the /w thing just a weak convention? Is there an established way for the URL of the api to be advertised?

Ideally, I'd like the user to just be able to give the URL of the wiki's main page, and for the URL of the API to be somehow discoverable from that. I think the normal URL of the main page is the easiest address for the user to give, especially given that tools using the API will be used by people who don't know what an "API", "web services", "mod rewrite" etc are. Jim Higson 15:00, 24 August 2007 (UTC)

If the user can give you the location of index.php (available by editing a page and looking at the URL), you should be able to replace index.php with api.php. But really you have no control over HTTP rewriting, so on a particular server it's possible that api.php is not accessible from the same place index.php is accessible from. CBM 16:39, 24 August 2007 (UTC)
Yes, I know about replacing the "index.php" with "api.php", but on most Mediawiki installations this won't work because it will try to rewrite the URL to index.php?title=api.php. Asking the user to edit a page and look at the URL seems not as user friendly as if they just had to enter the URL of the main page.
How about this as a suggestion for advertising the API: the main interface accepts action=advertiseapi, and when this is present responds with the URL for api.php? This way the API could be found quite easily by automated tools without preknowledge of that particular wiki's URL structure. Jim Higson 13:28, 25 August 2007 (UTC)

http response codes[edit]

I wasn't sure where to ask this, so please let me know if somewhere else would be better. I'm porting my bot (en:User:WatchlistBot) to java, using the API. I get an http response code of 400 when I try to write this page, and a 403 code when I try to write other pages (the 403 code is recent, the other has been happening for awhile). The pages seem to be written correctly despite the error codes. I'm an experienced java programmer, but new to http. I looked up generally what the error codes mean, but it's not very helpful. Can anyone tell me specifically what this means? I have an older version of the source posted and linked from the bot page. I can update that if it would help. Mom2jandk 20:11, 28 August 2007 (UTC)

A useful online tool for debugging http requests and responses is http://web-sniffer.net. Extract the exact request your bot is making, then make that same request from the web-sniffer and it will show you exactly what the server is responding with. --Nad 21:12, 28 August 2007 (UTC)
I had a look at the java code and noticed that "wpSave" was missing from the post request vars, to replicate a normal post MW may like to have that set to "Save page"? --Nad 21:27, 28 August 2007 (UTC)

GET method preview[edit]

See 11173 for details. Looking for some feedback.

Addendum: I have tested the LivePreview feature, and have determined that any vulnerabilities this could possibly introduce already basically exist via LivePreview and even normal Preview. Currently, to submit a preview, all you need is to send POST data for the wpTextbox1 and wpPreview=Show+preview (I believe). Splarka 23:45, 3 September 2007 (UTC)

Login using CURL + API[edit]

Hi, i tried to let the user login using api method

the code is like this:

$postfields = array(); $postfields[] = array("action", "login"); $postfields[] = array("lgname", "$id"); $postfields[] = array("lgpassword", "$pass"); $postfields[] = array("format", "xml");

foreach($postfields as $subarray) { list($a, $b) = $subarray; $b= urlencode($b); $postedfields[] = "$a=$b"; }

$urlstring = join("\n", $postedfields); $urlstring = ereg_replace("\n", "&", $urlstring); $ch = curl_init("http://mydomain.com/api.php"); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $urlstring); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $buffer = curl_exec($ch); curl_close($ch);

however, this code doesnot login the user when it is executed.

may i know whether i can use curl with mediawiki api?

or is there any other way to make the login works besides sending header location???

I don't see where you specify that cookies are to be used. I don't use libcurl under PHP, but the C binding has the options CURLOPT_COOKIEFILE, CURLOPT_COOKIEJAR, and CURLOPT_COOKIE, which are probably the same in PHP. Tizio 12:08, 12 September 2007 (UTC)
Try Snoopy, a PHP class that makes this much easier, and also supports cookies. --Catrope 14:23, 12 September 2007 (UTC)
Oh, i'm trying to put the variables like lgname, lgpassword in the link that will be post to the api, the links will look like this : http://mydomain.com/api.php?action=login&lgname=$id&lgpassword=$pass&format=xml

as i echo $buffer, it gave me the output like

<?xml version="1.0" encoding="utf-8" ?>

- <api>

 <login result="Success" lguserid="3" lgusername="Liyen" lgtoken="qq23f583d20cae7508d79abbbe8f8217" /> 

the output looks just like what we type in the browser address bar! how come curl is not working and if i type the link in the address bar, it works?

i'm too new to mediawiki api... can anyone please guide me..? please??? If i must use the cookie in this case, how can i apply it?

Thanks a lot!!! --Liyen

curl_setopt($ch, CURLOPT_COOKIEFILE, "cookies.txt");
curl_setopt($ch, CURLOPT_COOKIEJAR, "cookies.txt");
before curl_exec. Tizio 16:53, 12 September 2007 (UTC)

Count Revisions[edit]

It would be nice to get the total number of revisions while getting info for a given page. Currently one needs to make several calls if the number os revisions is larger than 50 (current limit). Is this being considered or are performance issues at stake? -- Sérgio

Get page contents after a given revision?[edit]

Hi, is is possible to get the page contents after a given revision? I know how to get the contents of the revision but what I currently want is the full page after the revision has been incorporated. --Sérgio

Those are the same. The contents of revision 12345 are the contents of the page after revision 12345 was incorporated. --Catrope 13:54, 8 October 2007 (UTC)

Wikipedia API URL bad guess[edit]

$ w3m -dump http://en.wikipedia.org/api.php
Did you mean to type w:en:api.php ? You will be
automatically redirected there in five seconds.

No, I meant to type http://en.wikipedia.org/w/api.php ... you see one cannot guess where it might be on different installations. Anyway, The above Wikipedia message could give a better guess. Jidanni 00:46, 24 October 2007 (UTC)

I think people going to en.wikipedia.org/Dog meaning to go to /wiki/Dog instead are a lot more common than people mixing up /api.php and /w/api.php Most people who use api.php know where it's located. --Catrope 22:34, 30 October 2007 (UTC)


Is there any function for sorting the query-results ? Especially for lists of pages ? Augiasstallputzer 12:16, 11 November 2007 (UTC)

No. But it's fairly trivial to write a script (PHP or otherwise) that sorts the list for you. -- 20:01, 11 November 2007 (UTC)

Problems with backlinks query[edit]


I am using the backlinks query for Wikipedia Cleaner and it seems that it's not working any more. I was using it with the titles parameter but I tried the bltitle and it's not working. The example provided in API:Query - Lists is not working also: http://en.wikipedia.org/w/api.php?action=query&list=backlinks&bltitle=Main%20Page&bllimit=5&blfilterredir=redirects returns no backlinks. --NicoV 21:07, 16 November 2007 (UTC)

It does for me. --Catrope 10:25, 17 November 2007 (UTC)
Yes, it's working now, but yesterday there was no <query> tag, only the <query-continue> tag. --NicoV 18:38, 17 November 2007 (UTC)

Used templates' paramaters[edit]

It'll be a great possibility to get used templates' parameters. Sorry, that was me :)

I mean - now I have to get page content and parse it for templates parameters (like Commons categories or coordinates) and this action generates a huge traffic. || WASD 01:22, 20 December 2007 (UTC)

Unfortunately, these parameters aren't stored in the database separately (only in the article text), so we can't get them efficiently. --Catrope 13:34, 20 December 2007 (UTC)
All right then, at least now I know that it's not possible :) || WASD 19:59, 20 December 2007 (UTC)


these parameters aren't stored in the database separately, but wouldnt it be useful to have the possibilty to parse default from the API? So, not anybody has to parse templates ba himself. Only a parameter which replaces {{ and | against < and of course template/xml closing ;)? No less traffic/computing time, but easier use. merci & greetz VanGore 22:31, 1 September 2008 (UTC)

The only thing this does is moving computing time away from the client to the server. Now parsing template parameters just once for one page may be cheap, but parsing them over and over again for hundreds or thousands of clients is not. That's why we try to move computing time from the server to the client if that's a responsible thing to do, like in this case. If the parameters were stored in the database, retrieving them on the server side would be cheaper then extracting them on the client side, so in that case this feature would obviously be added. But since it's not, it won't. --Catrope 11:30, 2 September 2008 (UTC)

Hi Catrope,

thanks for your reply. I understand that big projects like wikimedia-projects cant't offer xml-parsed templates. But for most Dataquerys, people use their own dumps. Would ist be possible to implement the template2xml in the only software, but not as default? I tried to reunderstand template-structur, I tried the hints in de:Hilfe:Personendaten/Datenextraktion but I didn't understand it. Do you know a documentation about the mediawiki templates? merci & greetz VanGore 10:12, 3 September 2008 (UTC)

Judging by the database queries in that document, I'd say it's way out of date. This wiki also has information about the general database layout and the table that keeps track of template usage. Template parameters are only stored in the actual wikitext, so you can't find them in any database tables. The wikitext itself is stored in the text table. --Catrope 13:44, 3 September 2008 (UTC)

Hi Catrope, I'd say it's way out of date. - Yes I searche too long for cur ;). Thanks for the rest, I will try no with theses information. Last Question: do know wehre I can find the php-code for templates? merci & greetz VanGore 15:08, 3 September 2008 (UTC)

The PHP code for parsing templates is probably in includes/parser/Parser.php , but the parser is a complex part of the MW code that's difficult to understand. You'd probably be better off writing your own code to extract template arguments. If you need advice, try talking to Tim Starling, he wrote the parser. --Catrope 15:23, 3 September 2008 (UTC)

Hi Catrope,

cool, I didn't saw the wood for the trees;) Reading includes/Parser.php and Manual:Parser.php is quite good for understanding, writing [my] own code to extract template arguments will be easier, I'll hope;) otherwise I'll come back or contact Tim.... merci & greetz VanGore 16:02, 3 September 2008 (UTC)

usercontribs not working any longer?[edit]

for example http://de.wikipedia.org/w/api.php?action=query&list=usercontribs&ucuserprefix=84.167 does not list edits made in 2008. i have to use "ucend" explicitly, but iirc yesterday i did not have to. so, is there no possibility to get the latest edits of a range (without setting "ucend")? -- 09:27, 27 March 2008 (UTC)

ucuserprefix now also sorts by username before it starts sorting by date. I know that's weird, but it's for performance reasons. --Catrope 20:02, 28 March 2008 (UTC)
ok, thx. so (as said in #Sorting) for me there's no opportunity to change that behavior? the only solution i can image now is a self-written script which gets the result of api.php and postprocesses the data offline. is there a better way? -- 17:06, 29 March 2008 (UTC)
I'll request a DB schema change so we can go back to the previous, more intuitive behavior while not killing performance. --Catrope 12:11, 6 April 2008 (UTC)

Getting the URL of a page[edit]

It would be very useful to have the full URL to the page in "prop=info". Is there any way to get it in another way? Thanks! -- OlivierCroquette 18:48, 3 June 2008 (UTC)

It's not that difficult. From /wherever/api.php you need to go to /wherever/index.php?title=Foo_bar . If the wiki uses pretty URLs, you'll automatically be redirected to the pretty URL. --Catrope 10:55, 20 June 2008 (UTC)
I'm also curious as to how to generate a full URL for a page. This seems like an odd thing not to provide. Here is the issue. I would like to give the API query string to an external application (SharePoint) that can consume an XML or JSON result and display a list of pages as links back to the wiki. There seems to be no property that generates a full URL.
One step further, it would be nice to add the ability to generate a full URL to list=categorymembers as well.
Konjurer (talk) 14:18, 10 January 2013 (UTC)

Generator + categoryinfo bug[edit]

I think I have found a bug in the API. (I don't have a bugzilla account and don't know how to use bugzilla so I'll report here instead.)

Bug description:

When using a generator to get a list of categories and then using "prop=categoryinfo", then the categoryinfo is not shown for all the categories in the list. I have tested this on several Wikimedia projects and I see the same bug on all of them.


We were discussing how to use the API to find redirected categories that still contain pages, so we can fix those pages. See en:Template talk:Category redirect#New categorization ideas. Using the API would be way more efficient than our current approaches.


Here are two different queries that show the bug. The first query lists the categoryinfo for the hard redirects. The other query lists the categoryinfo for our "soft" redirects (that is categories with our "this category is redirected" template on them).



I hope you guys can fix this. Since this would be a very good way for us to find the pages that need their categorising fixed. (Easier for the bots and humans, and costs less server load.) And it would work on all projects.

--Davidgothberg 12:35, 26 August 2008 (UTC)

This is really a symptom of a very different bug: categories that have a description page but never had any members aren't considered categories by the software. Filed at BugZilla. --Catrope 12:57, 26 August 2008 (UTC)
Oh! Your answer solves the problem in our case! Since if those categories never have had any members then we don't need their category info. Well, I think it solves it for all such usage, since as long as you know that "no category info" = empty category, then it should be okay. That should perhaps be documented in the API documentation.
Thanks for your answer. I know some bot owners on some projects that will be very happy to be able to use this query now. I'll report it to them.
--Davidgothberg 13:11, 26 August 2008 (UTC)
Knowing that no categoryinfo means no members is nice, but of course this is in fact a bug and should be fixed. The bug causing it is outside of the API, though, which is why I filed it at Bugzilla. --Catrope 14:37, 26 August 2008 (UTC)

Difference with query.php[edit]

There was an useful feature in query.php, when getting category members, allowed prop included timestamp (revision table) and touched (page table), with api.php we can get only the timestamp (action=query, list=categorymembers, cmprop = ids, title, sortkey, timestamp), touched is useful because you can implement a category members cache on client side, when categorymembers changes by adding/removing cat in article, touched is updated and the client know it must update its cache. Phe 07:58, 27 August 2008 (UTC)

You can get touched by using generator=categorymembers&prop=info --Catrope 11:15, 27 August 2008 (UTC)
Nice tip, thanks, and it was given as an example in the documentation ... Phe 15:56, 27 August 2008 (UTC)

is a xml-Schema or DTD for the api-Responses available?[edit]

Hi there. I'm working on a java-Client to access the mediawiki-API. I would like to use XML as the response format and JAXB to evaluate the API-responses. So it would be great if there is already a Schema or DTD to generate the corresponding Java-Classes. Thanks, --Gnu1742 10:50, 29 August 2008 (UTC)

We're working on such a feature, see this bug. --Catrope 21:00, 31 August 2008 (UTC)

Problems with action=edit[edit]

Hi, I have some problems with api.php?action=edit. It always tries to edit w/api.php instead of the page with the specified title. At first I though that it is a mod_rewrite problem, but the query parameters seem to be correct.

Seems to be this bug http://www.organicdesign.co.nz/MediaWiki_1.11_title_extraction_bug
If disabling your rewrite rules fixes this, it's not a bug in MediaWiki. --Catrope 20:59, 19 October 2008 (UTC)
Only a problem if you're using short url's. I have found a quick n' easy workaround, in your LocalSettings.php, wrap your $wgArticlePath="/$1" line with the condition: if (preg_match("/api\.php$/", $_SERVER['PHP_SELF'])) { ... } --FokeyJoe (2009-11-25)

Location Search?[edit]

Hi. This is my first time participating in a wikipedia discussion, so I apologize if I'm not following proper etiquette posting here like this. Over the summer, I had used some kind of location search to request a list of articles that were in a particular location. You could filter the results by the category the point of interest fell under (Natural formation, government institution, business, etc.). I can't seem to find any mention of this old functionality, which was quite handy. All I find are 2 jailbroken iphone apps, that seem to do this sort of thing.

The first is this app which is using a cached copy of the data set from the wikipedia-world project. It's close, but i'm sure there used to be (or maybe should be) a way of making these kinds of queries through the API.

The other is Geopedia, an iphone app which seems to do the kind of searching I thought was possible. However, there's no documentation, no homepage and no way for me to contact the developer to ask how they did this.

Am I going crazy? I could have sworn that there was a way of searching wikipedia articles for those that are within some distance of a specific coordinate pair. Can someone point me in the right direction?

As far as I know these coordinates aren't stored in the database separately, so any implementation that isn't hugely inefficient would have to make such a database table, either automatically using an extension, or using a database dump. --Catrope 18:25, 24 November 2008 (UTC)

Account simulation[edit]

With the ability to simulate an account when performing an action, mediawiki could be completely integrated into virtually any site. This would require a new sort of flag in localsettings to allow trusted systems to perform that way. For example, I'm interested in only the history and parsing/editing bits, and have my own account management, access control system, and page generation system. 01:57, 28 February 2009 (UTC)

You could just use action=login to log in with the account you want to 'simulate'. You can allow authentication from other sources with AuthPlugins. --Catrope 10:10, 28 February 2009 (UTC)

Persistent Connections?[edit]

Is there any possibility wikimedia's HTTP can be upgraded to 1.1, in particular, to allow persistent HTTP connections? Or is there some other way I'm missing of connecting to a persistent server so I don't have to re-establish connection for every single usage of the API? Language Lover 17:09, 20 April 2009 (UTC)

It appears to me (and good old openssl and wireshark) that the secure.wikimedia.org server does indeed allow persistent connections and does support HTTP/1.1 keep-alive as standard. -- JSharp 01:31, 21 April 2009 (UTC)
Oops, I think you might need this: [1] . It's the ssl-enabled link to the en.wp API. :) -- JSharp 01:36, 21 April 2009 (UTC)
Are there any news? I am facing the same Problem. My application sends many but very short requests (with very short answers). So connection opening and closing takes most of the time and traffic for each request. Persistent connections would speed up things. (Even secure.wikimedia.org seems to disallow persistent connections).

How to integrate[edit]


Apologies for being totally ignorant of HTML and MediaWiki, but I wonder if there's a way using MediaWiki markup or using HTML to get the output of a query (such as this one) into a Wikipedia page, formatted in some reasonable way. As I don't regularly check this site, I would appreciate a {{talkback}} at my en talk page (in sig below).

Thanks Bongomatic 04:24, 1 October 2009 (UTC)

Image license information[edit]

Is there a way to get the license of an image through the api?

By category is probably easiest, assuming the site categorizes by license. There is no built in module though for license information. Splarka 08:45, 22 January 2010 (UTC)

Possible to detect a page's existance?[edit]

Hi there. I'm currently working on a bit of PHP software. I'm wondering if it's possible to detect a page's existance using the API? If not, is there any external way of doing so? Thanks. Smashman2004 21:42, 7 July 2010 (UTC)

Fail reply is fail. Smashman2004 16:41, 15 July 2010 (UTC)


Does the API implement any type of throttling for non-Bot users? There is discussion at the Spam attacks article on the Signpost this weeks about the need for such throttling. Apparently the attacker mentioned in the article was able to post at an average rate of 1 article per second, which is a little bit scary. Best practice among bot operators is generally no faster than 1 post every 5 seconds. Hard-coding such a limit into the API (at least for accounts not approved as Bots) might not be a bad idea. Kaldari 17:15, 17 August 2010 (UTC)

Manual:$wgRateLimits applies to the api as well as normal edits as far as i know. Bawolff 23:23, 17 October 2010 (UTC)


Is there a way to get someone's userid from the api?

raw code[edit]

The documentation says that for the source code of pages "index.php?action=raw" should be used. Is this mandatory or is there a way to do it over the API? --::Slomox:: >< 00:13, 22 November 2010 (UTC)

yes you can. See API:Query_-_Properties#revisions_.2F_rv. Bawolff 03:58, 22 November 2010 (UTC)

Support for multiple categories when using list=categorymembers[edit]

  • jlaska - I see there are extensions that allow querying for ages that are members in multiple categories (such as Extension:CategoryIntersection and Extension:Multi-Category_Search). Those are nice as they provide a Special: page, however they don't appear to add API support. From what I've tested, it appears that list=categorymembers does not support joining multiple cmtitle= values. Are there plans to add this support, or alternative API methods for finding pages that exist in multiple categories?
I was thinking on using two queries for an and-query where the second query would use the returned pageids from the first query with parameters action=query, list=categorymembers and the pageids parameter, but the pageids parameter does not restrict the search to pages among the list of pageids. — Fnielsen (talk) 10:29, 6 October 2012 (UTC)

Extract headings and subheadings[edit]

Hi. Can the API extract headings and subheadings easily? Cheers, 11:20, 13 March 2011 (UTC).

Sure --Catrope 11:40, 13 March 2011 (UTC)
Thank you Catrope; very useful! 22:04, 13 March 2011 (UTC)

Extract all links of a given page[edit]

Hi. Can I extract all links of a given page easily using the API? Thanks. 22:02, 13 March 2011 (UTC)

You can get all links on a page or get all links to a page. --Catrope 22:45, 13 March 2011 (UTC)
Thanks. Randomblue 11:11, 14 March 2011 (UTC)
Is it possible to sort them by the order they are in the page? Helder 14:59, 14 March 2011 (UTC)
No. --Catrope 17:49, 14 March 2011 (UTC)

Stripping off templates, refs, interwiki links, etc.[edit]

Hi. Can the API keep only the text (with links) and headings from an article, stripping off all the rest? Thank you. Randomblue 11:11, 14 March 2011 (UTC)

No, you'd have to do that yourself somehow. --Catrope 11:24, 14 March 2011 (UTC)

Extracting template information[edit]

I would like, for example, to extract information from infoboxes. Suppose that I'm interested in country infoboxes. I would like to be able to extract, for each page that transcludes the country infobox, basic information such as "capital", "population", "president", etc. Has this already been done? What would be the best way to do this? Cheers, 17:39, 22 March 2011 (UTC).

This is not available from the API directly. There are projects like DBpedia that have done work in this direction --Catrope 14:51, 23 March 2011 (UTC)

A way to retrieve article class?[edit]

Even though I've searched the MediaWiki API thoroughly I haven't found a way to retrieve article class information, such as A-class, good, featured etc. Exported article text does not contain this information, nor is there a property corresponding to it. Moreover, dumping the page content with perl's WWW::Mechanize doesn't help because the relevant text is generated on they fly and is not captured by Mechanize.

I'd appreciate any pointers… Patrinos 08:52, 9 April 2011 (UTC)

Concepts like featured articles were invented by Wikipedians, but they don't exist as such in the MediaWiki software. You may be able to detect featured-ness using categories or templates used on the page or something like that. --Catrope 10:15, 12 April 2011 (UTC)

apfrom bug?[edit]

Hi. 1) I load from '%' http://en.wikipedia.org/w/api.php?action=query&list=allpages&apfrom=%&aplimit=11&format=xml 2) apfrom is '%d' so, I get http://en.wikipedia.org/w/api.php?action=query&list=allpages&apfrom=%d&aplimit=11&format=xml 3) now apfrom is %25 so, I get http://en.wikipedia.org/w/api.php?action=query&list=allpages&apfrom=%25&aplimit=11&format=xml 4) voilà, i'm on '%' again, why? Emijrp 09:40, 9 April 2011 (UTC)

Because you didn't w:percent-encode your parameters when constructing your URL. --R'n'B 11:32, 10 April 2011 (UTC)

API queries from PHP[edit]

Are all API queries callable using PHP, e.g. for MediaWiki extensions? Randomblue 15:49, 10 April 2011 (UTC)

Yes, see API:Calling internally. However, for most things you'll probably want to use core functionality or a database query rather than going through the API. --Catrope 10:17, 12 April 2011 (UTC)

retrive data from a category with more then 500 articles[edit]

I want to make a list of the Italian_verbs from Wiktionary. I use the query:

To get the first 500 items. How do I get the rest of the data? (I think It has to do with cmcontinue but I don't understand how to use it... thanks Jobnikon 17:31, 8 May 2011 (UTC)

At the bottom, you'll see <categorymembers cmcontinue="page|1833609|ALLOTTARE ALLOTTARE" />. So to get the next 500 results, repeat the same API call with cmcontinue=page|1833609|ALLOTTARE%0AALLOTTARE (the %0A part is what you get when you XML-decode then URL-encode ). --Catrope 16:36, 9 May 2011 (UTC)

List of images with links[edit]

Please is there a way in the API to get list of images in a wiki with the pages that link to this images --Mohamed Ouda 14:15, 2 July 2011 (UTC)

Not in one request, no. You can get the list of all images with list=allimages and you can get the list of pages linking to a specific image with list=imageusage. The latter only takes one image at a time though. --Catrope 10:21, 3 July 2011 (UTC)

Get translations from wiktionary?[edit]

I wonder how to use wiktionary to translate words, for exaple to get a datadump with all the english words, and their translation in spanish? I have seen it done on this site http://www.dicts.info/doc/dl/download.php so its possible. But how do they do it?

Probably by downloading a dump of all Wiktionary content and parsing the translations out of it. MediaWiki itself doesn't treat the translations specially, they're just words appearing in a box with fancy styling, so the API doesn't provide any way to retrieve these short of grabbing the entire page content and parsing out the translations yourself. --Catrope 09:01, 28 October 2011 (UTC)

Problems with MW1.18?[edit]

We're in soft launch for a new wiki and playing around with the MW1.18 (yes - we know it's beta). In testing out the HotCat gadget, we've noticed a problem with our API. It wasn't an issue with MW1.17 and while we are playing around with things during the soft launch, I can't think of any settings that would have an impact on that. The API was working correctly before MW1.17 - and nothing was changed between the upgrade and test of API. It doesn't seem to output all of the data. Examples:

Anyone have any ideas? --Varnent 01:41, 11 November 2011 (UTC) (updated URLs)

This was fixed in trunk in r99236 but it was overlooked and didn't make it into the 1.18 beta. I've tagged it for 1.18 so it'll go in the final release. You can try applying the diff of that revision locally (it's an easy one), that should fix it. --Catrope 13:13, 11 November 2011 (UTC)
Excellent - thank you!! --Varnent 19:27, 11 November 2011 (UTC)

enable API[edit]

If this is the article on how API works, shouldn't there be a short blurb that you add $wgEnableAPI = true to enable it? Or is that not correct? These instructions are always so subpar. Igottheconch 06:57, 12 December 2011 (UTC)

The API is enabled by default in non-ancient versions of MediaWiki. Also, if you feel the instructions are "so subpar", by all means go and improve them. It's a wiki, anyone can edit. --Catrope 14:53, 14 December 2011 (UTC)

Doubled Content-Length in HTTP Header[edit]

I posted this on the help desk, but it probably is more appropriate here:

  • MediaWiki version: 16.0
  • PHP version: 5.2.17 (cgi)
  • MySQL version: 5.0.91-log
  • URL: www.isogg.org/w/api.php

I am trying to track down a bug in the api which is causing a double content-length in the header. This is causing a lot of issues with a python bot. Here is the report from web-sniffer showing the content of the api.php call from this wiki. All other pages when called, i.e. the Main page, etc. only report 1 content-length. Is the api forcing the headers? Why is doubling only the one?

Status: HTTP/1.1 200 OK
Date: Mon, 30 Jan 2012 14:31:25 GMT
Content-Type: text/html; charset=utf-8
Connection: close
Server: Nginx / Varnish
X-Powered-By: PHP/5.2.17
MediaWiki-API-Error: help
Cache-Control: private
Content-Encoding: gzip
Vary: Accept-Encoding
Content-Length: 16656
Content-Length: 16656

As you can see this is a Nginx server. On an Apache server with 16.0, only one content-length is sent. Could that be the issue and how do I solve it? Thanks.

-Hutchy68 15:10, 30 January 2012 (UTC)

Wanted: showcase of cool uses[edit]

I'd like to get a showcase of uses of the MediaWiki API -- can anyone link to apps or tools that use it well or interestingly? Sumana Harihareswara, Wikimedia Foundation Volunteer Development Coordinator 22:55, 1 February 2012 (UTC)

A basic use (for editing pages) is described on w:Wikipedia:WikiProject User scripts/Guide/Ajax#jQuery examples. Helder 12:13, 2 February 2012 (UTC)

Is it possible to edit the length of a search snippet?[edit]

Using the prop parameter "snippet" returns a small part of the beginning of the article, and for my needs it is a bit too small. Is there any way to edit the length (when using the API) of the snippet returned, to make it longer? -- 21:42, 24 March 2012 (UTC)

Personal attack removed

template including list[edit]

How to get list of pages which includes template throw api? Without api I can get it using Special:WhatLinksHere but same api function does not return this information to me... Sorry for my low level of English and if I ask at wrong place. --Base (talk) 15:54, 21 May 2012 (UTC)

I founded answer it is API:Embeddedin. Thanks --Base (talk) 16:12, 21 May 2012 (UTC)

API_talk:Usercontribs#Just new pages[edit]

Please answer my question here: API_talk:Usercontribs#Just new pages. Thanks. --BaseBot (talk) 20:48, 1 June 2012 (UTC)


Should we encourage usage of action=tokens, to fetch tokens, rather than the method described in API:Edit and related pages? →Στc. 01:26, 9 June 2012 (UTC)

Wikt markup removed from API output[edit]

Querying the API for an article which has a wikt markup causes the term to be absent from the API response. See: http://en.wikipedia.org/w/api.php?action=opensearch&format=xml&search=Uncanny+Valley and http://en.wikipedia.org/wiki/Uncanny_valley . The word 'revulsion' is absent from the API response.

API:Edit - Set user preferences and other old proposals[edit]

It doesn't make sense to keep that with the same naming convention as everything else. Is there already a convention for a better place to put it? If not, what about API Proposals/Edit - Set user preferences in the main namespace. I don't think the Manual: namespace works either, since the manual should be for stuff in the actual software. Superm401 - Talk 21:22, 30 January 2013 (UTC)

"What links here" API request[edit]

How would I format a request to the API to get a count of how many pages link to a specific page? I'm trying to write myself a little JavaScript which in part will expand the "What links here" link in my p-tb to include an count of pages that link to a specific NS (or two or three) and a total count of pages that link to that article. I intend to use such a script to save me some time when I'm tagging articles for improvement on enwiki to quickly know if the article is an "orphan" or not. Thank you. T13   ( C • M • Click to learn how to view this signature as intended ) 15:30, 12 April 2013 (UTC)

Okay, so I have found that "api.php?action=query&list=backlinks&blnamespace=0&bltitle=" + wgPageName; will tell me if there are any articles that link to the page, but how can I get the full count (if greater than 500)? I don't care "what" articles link there, just how many. T13   ( C • M • Click to learn how to view this signature as intended ) 17:01, 12 April 2013 (UTC)

user is deleting text[edit]

Can someone deal with this user. Can someone block him. 23:45, 29 April 2013 (UTC)

Dealt with. Clearly not interested in contributing constructively.--Jasper Deng (talk) 23:55, 29 April 2013 (UTC)

Retreiving List Pages/ Category pages[edit]

Hey, I am trying to use the API to retrieve the pages inside a given list or category. This query seems to be working from me to get, for instance, the response of everyone in the category American_film_actors Link: http://en.wikipedia.org/w/api.php?action=query&list=categorymembers&cmtitle=Category:American_film_actors&cmlimit=30&format=json

But I can't find in any of the documentation any of the documentation how to do something like this with a list page, ex. List_of_accordionists Link

Is it possible for someone to point me in the right direction or pass me a sample query that will accomplish this?

You mean the list of links in the page ? See links / pl. --NicoV (talk) 21:01, 13 June 2013 (UTC)

That was it! thanks very much!

Selective leak of data provided by recentchanges as a generator[edit]

Here is some request:


It should return categories for latest new pages, but it's behave is weird to me. For some pages it returns categories and for others it doesn't. It's not about outdated data in API (eg. someone already added categories, but API still doesn't knows that), because many of pages with no categories (as API reports), actually got categories.

Can somebody help me at that -- 15:28, 29 June 2013 (UTC)?

Ask about active user[edit]

Hello, I want to ask about how mediawiki api count active users.

When, I see the site statistic (https://id.wikipedia.org/w/api.php?action=query&meta=siteinfo&siprop=statistics). It said that, there are 1743 activeusers. But when I list all of the active users (https://id.wikipedia.org/w/api.php?action=query&list=allusers&auprop=editcount%7Cgroups%7Cregistration&aulimit=500&auactiveusers), there are more than 1743 rows.

Is there anyone who can explain? Then, it also has different result with the special page (https://id.wikipedia.org/wiki/Istimewa:Pengguna_aktif). Is it possible to extract data from mediawiki api that has the same result with Special:ActiveUsers page? Thank you. William Surya Permana (talk) 17:41, 10 August 2013 (UTC)

abuselog: Permission denied[edit]

I have all needed rights to see abuse log, but request "action=query&list=abuselog" return error with code="aflpermissiondenied" info="Permission denied" --AS (talk) 16:02, 22 December 2013 (UTC)

Works fine for me, even when logged out, on this wiki. If you are talking about a different wiki, make sure that a group you are in has the abusefilter-log permission in Special:ListGroupRights. --Skizzerz 18:38, 22 December 2013 (UTC)
Now works for me too... Anyway, thanks. --AS (talk) 22:38, 22 December 2013 (UTC)

Removing formats except JSON[edit]

According to the page, there are plans to remove all formats except JSON. First off, what do we have that supports that statement? Second, I would assume that XML would also be a standard format that would be kept, but that needs to be made clear, assuming I'm correct. – RobinHood70 talk 05:57, 8 January 2014 (UTC)

For anyone interested, the proposal is indeed to remove XML. You can read more about it here. – RobinHood70 talk 03:32, 26 February 2014 (UTC)


Is there a way to retrieve the url for the wiki's logo? I expected it to be in meta siteinfo, but it's not. 07:12, 25 March 2014 (UTC)

There's logo="//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png" in the result from siteinfo. --NicoV (talk) 07:20, 25 March 2014 (UTC)
Hmm, that's not in the example, must be outdated. Thanks! 11:04, 25 March 2014 (UTC)

An error with api[edit]

I Cannot access api.php and it gives me this error : Parse error: syntax error, unexpected T_FUNCTION in C:\AppServ\www\wordpress\mediawiki-1.19.15\includes\api\ApiFormatBase.php on line 279 Please help! — Preceding unsigned comment added by (talkcontribs) 11:04, 25 March 2014‎

Looking at it, I saw nothing wrong, so I googled it and came up with this. It sounds like you've got PHP 5.2, where this seems to expect PHP 5.3 or above. – RobinHood70 talk 20:08, 8 April 2014 (UTC)

Internal error in ApiFormatXml::recXmlPrint() has integer keys without _element value[edit]

Apparently, since yesterday, some requests give this error.

Example: https://fr.wikipedia.org/w/api.php?bltitle=BNF&action=query&blredirect=&list=backlinks&format=xml&bllimit=max gives

<?xml version="1.0"?>
<api servedby="mw1053">
  <error code="internal_api_error_MWException" info="Exception Caught: Internal error in ApiFormatXml::recXmlPrint: (redirlinks, ...) has integer keys without _element value. Use ApiResult::setIndexedTagName()." xml:space="preserve" />

Also reported in MediaWiki-API mailing list. --NicoV (talk) 08:45, 10 October 2014 (UTC)

The problem is visible in WPCleaner and AWB. Problem reported as bug 71907 by AWB developer. --NicoV (talk) 13:52, 10 October 2014 (UTC)

How to deal with error while getting all users[edit]

Hi, I am trying to get the list of all users. Mostly I get the following error:


   "servedby": "mw1196",
   "error": {
       "code": "internal_api_error_MWException",
       "info": "Exception Caught: Internal error in ApiQueryAllUsers::execute: Saw more duplicate rows than expected",
       "*": ""


So I reduce the number of users the API is getting at each call to 1, and even then I get the error. For example, see: https://en.wikipedia.org/w/api.php?action=query&list=allusers&format=jsonfm&aufrom=!!!%20Professional%20Analism%20Account!%20ATTAAAAAAAACK!!!!&aulimit=1&auwitheditsonly=%22%22&auexcludegroup=bot

How do I deal with this error now? Any other way to get the list of all users?

Srijankedia (talk) 20:37, 26 October 2014 (UTC)

There's nothing wrong with your code, it's a problem with the PHP code on Wikipedia. Anomie is probably the best person to look into that, since he's been working heavily on the API code recently. Hopefully, he'll comment shortly. There's no other direct way of getting the user list via the API. – RobinHood70 talk 05:29, 27 October 2014 (UTC)
Okay. I hope this gets resolved soon. I have to use it urgently, or I would just crawl the Wikipedia website :) Srijankedia (talk) 17:36, 27 October 2014 (UTC)
Great! It seems to be fixed now. Thanks for the quick work on this. Srijankedia (talk) 00:23, 28 October 2014 (UTC)

Missing documentation pages[edit]

import pywikibot
s = pywikibot.Site('mediawiki', 'mediawiki')
missing_docs = sorted([p for p in [pywikibot.Page(s, 'API:' + module.title()) for module in s._paraminfo.query_modules] if not p.exists()])
print('The following query modules do not have documentation:')
for p in missing_docs:
    print('* [[' + p.title() + ']]')

The following query modules do not have documentation:

Many of these could be a redirect to an existing relevant documentation page. For the ones which are not covered by wiki documentation yet, maybe they could be Google Code-In tasks? (and no the api.php help is not a good replacement; it only documents the *current* API, and not always accurately - it doesnt document which version various features were added, or provide a place that people can add notes about oddities.) John Vandenberg (talk) 12:22, 28 November 2014 (UTC)

It would probably be more useful if you used the 'helpurls' property in the action=paraminfo result, instead of blindly assuming that "API:$modulename" should exist. Anomie (talk) 14:17, 1 December 2014 (UTC)
I've created redirects for all modules which have a 'helpurls' property. p.s. the helpurls for 'Betafeatures' is a broken link. There are many modules without a value in the helpurls property, which are all the red links above. John Vandenberg (talk) 17:35, 4 December 2014 (UTC)

user:RobinHood70 has done a massive restructure of API:Properties and API:Meta, splitting each module to be a separate page. template:API-head now automatically links to the current action=help page for the module, so wiki documentation can be started by simply adding {{API-head}} to a page, like API:Fileusage.

Worth noting, it is now possible to use {{Special:ApiHelp/query+flowinfo}} to produce

prop=flowinfo (fli)

(main | query | flowinfo)
  • This module is deprecated.
  • This module requires read rights.
  • Source: Flow
  • License: GPL-2.0+

Get basic Flow information about a page.

I find that layout ugly, but it is better than nothing.

See also Thread:Project:Current_issues/Api_documentation_bot. John Vandenberg (talk) 07:08, 22 February 2015 (UTC)

If RobinHood70 hasn't already, someone should submit a patch to update the return value of getHelpUrls() in the affected modules. Anomie (talk) 14:20, 23 February 2015 (UTC)
Sorry, that hadn't even occurred to me. I've gotten out of MediaWiki code modification. As a Windows user, I found it completely unintuitive and I was spending up to an hour just to make the tiniest change, and not sure I'd done it right even then. To add to the fun, I'm cognitively impaired and both times that I submitted something, I was pretty much useless afterwards. So no, no more code mods for me, at least not until we make modifying the code as easy as changing a wiki page (hint!). Sorry to dump this work on someone else's lap, but submitting code modifications is just not something I'm able to get into in any meaningful way. Robin Hood  (talk) 16:35, 23 February 2015 (UTC)
Actually, it just occurred to me, I don't have to be the one to actually submit the changes. I think I can manage a git clone without too much difficulty, so I can go through the files and make the necessary changes, then zip them up and send them to someone else if that would be easier. Robin Hood  (talk) 16:57, 23 February 2015 (UTC)
Okay, if anyone wants it, I have a zip file with all the changed files as well as a patch file if that's any better. The zip file is here, since we can't upload zip files to MW. Robin Hood  (talk) 19:32, 23 February 2015 (UTC)
You could try the Gerrit patch uploader to upload the patch. Anomie (talk) 13:48, 24 February 2015 (UTC)
I'd forgotten that existed. Thanks, Anomie! Pending the outcome of the discussion on my talk page, I'll give it a try. Robin Hood  (talk) 16:17, 24 February 2015 (UTC)
User:RobinHood70, I took your patch set and did git apply /tmp/RobinHood70/patch.diff, and submitted it with git review. It's up at gerrit:202368. I tested all the help links, it looks good to me. Thanks for doing this! I still think it could be better to move the wiki pages for query submodules to be actual subpages of API:Query (or maybe subpages of [[API:Lists], API:Meta, API:Properties) so that you can navigate back to the API wiki pages , but this is forward progress. Onward :-) -- SPage (WMF) (talk) 10:20, 7 April 2015 (UTC)

Question regarding Wiki ID and similar propertes[edit]

I stumbled over a website that seems to collect mediawiki API information for mediawikis all over the web. I found my wiki there with a value "Has Wiki ID" displayed. What is this wiki ID and how can I avoid that this information is visible or influence what is displayed there at all or is this depending on the server setup? I did check the wikiapiary.com entry from a friend's mediawiki project. For his project some properties where not displayed that are visible for mine, so I wondered --CayceP (talk) 13:22, 14 January 2015 (UTC)

It appears that the "Wiki ID" reported there is the wikiid property in the meta=siteinfo query with siprop=general, which in turn depends on the values of $wgDBprefix and $wgDBname for your wiki. You could modify this information using the APIQuerySiteInfoGeneralInfo hook, although doing so seems rather pointless. Other properties listed on that site presumably come from other data in meta=siteinfo or other API queries. Anomie (talk) 14:27, 15 January 2015 (UTC)

Using API for retrieving images hosted at Commons (variable must be resolution and upload date)[edit]

Hi! My post at Commons:Forum#Bilder nach Auflösung über Kategorien etc. suchen (in German) did not result in something which I can manage, so I am trying my luck here :-). I am looking for an API query which is able to retrieve images uploaded at Commons on a certain date or period with small resolutions (500/640/960/1024 etc. height or width). Variables must be resolution and date. I tried to use some parameters via API:Allimages and Manual:image table, constructing a query based on timestamps via

  • aistart
  • aiend

and resolution size in pixel via

  • img_width
  • img_height

but all efforts failed. A listing by ascending or descending order by upload date would be great. Is there a good alm who could orientate me? Thx. --Gunnex (talk) 00:08, 21 February 2015 (UTC)

You can't filter by size in the original query, so you'd have to download all the information, then filter the results down to just the ones you're looking for. The query would look like this:
Change the dates to whatever you need. Let me know if you need any additional help. Robin Hood  (talk) 02:04, 21 February 2015 (UTC)
I got it! I added some more parameters (user/url/limit/nobots) and with
  • https://commons.wikimedia.org/w/api.php?action=query&list=allimages&aiprop=size|user|url&aisort=timestamp&aistart=2015-02-19T00:00:00Z&aiend=2015-02-20T00:00:00Z&aifilterbots=nobots&ailimit=200
I can work almost perfectly. Thx for the help! --Gunnex (talk) 10:57, 21 February 2015 (UTC)
No problem. Glad to hear you got it working! Robin Hood  (talk) 15:27, 21 February 2015 (UTC)

Author and timestamp[edit]

Hi, which query would recommend to query for the author of an article and the respective timestamp. So I'm looking for the meta data of the first revision of a certain article. --jobu0101 (talk) 13:25, 29 March 2015 (UTC)

Just replace the wiki and titles with whatever you need. Note that you can only query one page at a time with this method. Robin Hood  (talk) 15:23, 29 March 2015 (UTC)
Thank you very much! --jobu0101 (talk) 22:45, 29 March 2015 (UTC)

Number of backlinks[edit]

I found out how to generate a list of all backlinks (see here). But I'm more interested in the number of backlinks. Is it possible to simply get the number of backlinks? --jobu0101 (talk) 07:43, 8 April 2015 (UTC)

Not currently. The feature request is phab:T19993; note that an implementation would likely return a number from 0 to 'limit', or some indicator that there are more than the limit (e.g. if the limit is 100, 0–100 or "101+"). Anomie (talk) 13:16, 8 April 2015 (UTC)
Too bad. So calculating the number will result in a big amount of traffic with the current API. --jobu0101 (talk) 13:33, 8 April 2015 (UTC)
By the way there are some examples where it is possible to access the number of results using another method. For example it's possible to get the number of edits a certain user has made without going through all edits an counting them manually. How do you know that there is no other possibility for this backlink issue? --jobu0101 (talk) 13:39, 8 April 2015 (UTC)

API and FlaggedRevs[edit]

How to check (via API) if article have been reviewed/have never been reviewed/have at some point been reviewed, but the most recent revision is not reviewed? Malarz pl (talk) 09:27, 13 April 2015 (UTC)

See the examples on the FlaggedRevs page, here and here. Robin Hood  (talk) 16:42, 13 April 2015 (UTC)
I also found that list = unreviewedpages gives some of old reviewed pages if I’m not at least an editor, but I don’t know exactly what (it’s probably a bug). --Tacsipacsi (talk) 16:50, 13 April 2015 (UTC)
I'd like to check one article. I don't need list of all unreviewedpages / oldreviewedpages. Malarz pl (talk) 06:42, 14 April 2015 (UTC)
The start and end parameters will help for unreviewedpages (set both to the title you're looking at), but it looks like there's nothing that can easily be done for the oldreviewedpages. I'd suggest posting on the extension's talk page and maybe the authors will add that functionality. Robin Hood  (talk) 17:28, 14 April 2015 (UTC)

Existence of articles[edit]

I have a question related to the question of Smashman (talk · contribs) which he posted almost five years ago without getting any answer. Of course I know that almost all queries where you ask for certain information about a page lets you also know if the page doesn't exist. But is there a canonical way to ask the API if certain pages exist? I'm looking for a solution with very less output. Just a yes/no is enough (maybe a third possibility in case the page exists but is a redirection). --jobu0101 (talk) 17:04, 14 April 2015 (UTC)

For a yes/no, the closest you'll get is action=query with no submodules, like this. If you want redirect status too, you can add &redirects=1 or use prop=info. Anomie (talk) 13:04, 15 April 2015 (UTC)
Thank you. That's quite good. I didn't come that close. --jobu0101 (talk) 16:26, 15 April 2015 (UTC)

Tokens 2[edit]

Hey, can you have a look here? --jobu0101 (talk) 17:52, 1 May 2015 (UTC)


In ApiSandbox it is not possible to "set" the "Parameter for query" -> "continue" to an empty string. At least the xml returned has different tags (ex. a <query-continue> tag) from the ones that exist if the continue parameter is included as an empty string. This way new users using the ApiSandbox are disoriented. --Xoristzatziki (talk) 18:59, 21 June 2015 (UTC)

I'm working on fixing ApiSandbox to allow present-but-empty in gerrit:209570; in the mean time, you're unfortunately out of luck with that one. Anomie (talk) 13:31, 29 June 2015 (UTC)

changes of revisions[edit]

Is there a simpler way to get anything that caused a recent revision change in articles? Anything that modified the content or the number of the articles in the wiki. This will be useful to keep updated the "pages-meta-current" xml file got from dumps.wikimedia.org, until we have a new dump. Aka:

  • edits (any edit. Either by users or by bot or by moving the article to a new name and changing the content to "#redirect xxx", anything that changes the content of the page),
  • deletions (any deletion that removed the article from the article list, ex. a move by a sysop that do not created a "#redirect xxx"),
  • new articles (either by creation or by undeleting a page or by moving a page to a new name or anything that adds an article in the article list of the wiki)

--Xoristzatziki (talk) 05:46, 23 June 2015 (UTC)

action=query&list=recentchanges? Anomie (talk) 13:32, 29 June 2015 (UTC)

Implications of the Data & Developer Hub project on Api: namespace[edit]

There is an ongoing discussion about dev.wikimedia.org and the implications it might have revamping this namespace (as opposed to creating a new one in Dev:). Please check Thread:Project:Current_issues/Adding_a_dev_namespace_for_"Data_and_developer_hub"_articles and reply there.--Qgil-WMF (talk) 06:03, 1 July 2015 (UTC)

  • Summary. We decided to add articles to this namespace (API:) rather than creating a new one. That leads to figuring out how to organize the API namespace now that it covers more than just the "classic, PHP" action API (phab:T105133). -- SPage (WMF) (talk) 02:31, 27 August 2015 (UTC)

IRC office hour on APIs and the mw.org namespace[edit]

Tuesday 2015-09-01T18:00 UTC (11am San Francisco time) we will be having an IRC office hour about

  • T105133 - Organize current and new content in the API: namespace at mediawiki.org
  • T101441 - Integrate the new Web APIs hub with mediawiki.org
  • T98897 - Deploy SkinPerNamespace extension on mediawiki.org

If you're interested in developing with, documenting, or promoting MediaWiki/Wikimedia APIs, you should attend. I hope by having a realtime conversation we can come to a shared understanding faster. -- SPage (WMF) (talk) 02:31, 27 August 2015 (UTC)

Renaming this page, front doors to the APIs[edit]

This page is no longer a Main_page for APIs (plural), it's an introduction to the MediaWiki action API, our biggest and oldest API. The next step is to rename the page to more accurately reflect its role. Already the {{API}} navigation template links to it as the "MediaWiki APIs" heading and as "Introduction and quick start" (I just now renamed the latter from "Quick start guide"). My choice is:

API:Introduction to the action API

which accurately if incompletely describes its content, so unless someone has a better suggestion I'll rename the page to that. API:Main_page will of course redirect to the new name.


  • trimming to "API:Action API" makes the page mysterious
  • expanding "API:Introduction to the MediaWiki action API" feels unnecessarily long
  • "API:Action API introduction and quick start" is even more informative and would match its item in the {{API}} navigation template, but is too wordy. :-)

Note that for certain developers, API:Web APIs hub is a better introduction to "the APIs that let you access free open knowledge on Wikimedia wikis." Eventually I think "Web APIs hub" should be the destination of the heading MediaWiki APIs in the {{API}} navigation template.

This is part of phab:T105133, "Organize current and new content in the API: namespace at mediawiki.org".

-- SPage (WMF) (talk) 20:50, 31 August 2015 (UTC)

The current aliases, as seen in the redirects. Cpiral (talk) 18:55, 19 January 2016 (UTC)

API use in wiki-family environment?[edit]

Has anyone had experience with using the API in a wiki-family setup? We're using the giant switch statement method and a single database with different prefixes to separate the installs.

&redirects not working as expected[edit]

tried https://commons.wikimedia.org/w/api.php?action=query&titles=Category:Biserica%20fortificat%C4%83%20din%20Al%C5%A3%C3%A2na&redirects The category Biserica fortificată din Alţâna is a redirect, but the API result doesn't display this... What is wrong? --Arch2all (talk) 10:01, 7 November 2015 (UTC)

Reason seems to be, that Category redirects are "soft" (Template "Category redirect" instead of #REDIRECT). I succeeded to check this with https://commons.wikimedia.org/w/api.php?action=query&prop=templates&tltemplates=Template:Category_redirect&titles=Category:Biserica%20fortificat%C4%83%20din%20Al%C5%A3%C3%A2na
But now I only know, that the page is a redirect, but not the target. How can I achieve this (find out the parameters of the redirect template)? --Arch2all (talk) 11:22, 7 November 2015 (UTC)
Finally I found out to extracted the new title by parsing the links to namespace 14: https://commons.wikimedia.org/w/api.php?action=parse&prop=links&page=Category:Biserica%20fortificat%C4%83%20din%20Al%C5%A3%C3%A2na
This works for now, but is pretty complicated (need 2 API calls). Maybe someone nows an easier way? --Arch2all (talk) 12:17, 7 November 2015 (UTC)
Soft redirects are, in essence, pages like any other article, so there's no easy way to figure out where they redirect to. Your method is one way. Another one is to load the page text itself via a revisions query (or via parse, if you prefer) and then parse the resulting text for the template itself. That, of course, requires that you know the template's name and how it works—not a big issue if you're working only on Commons, but if you're loading pages from different wikis, it's gonna be tricky, since you'd need to know all the right names and whether they all work the same. There's no other solution that I can think of. Robin Hood  (talk) 22:59, 7 November 2015 (UTC)
Thanks for the detailed answer. I'm just interested in redirects on commons, so it's not to tricky. Maybe I better analyze the redirect pages wiki text myself with a revision query (as You mentioned) instead of a parse query with automatically extracted links to avoid getting the wrong link (if there are several links to namespace 14). --Arch2all (talk) 08:21, 8 November 2015 (UTC)

Server returned HTTP response code: 500 for URL: https://www.wikidata.org/w/api.php[edit]

When I try to login to Wikidata I keep getting a 500 error. I don't have any problems with logging in to Wikipedias. --jobu0101 (talk) 20:43, 20 January 2016 (UTC)