Skip to content

mudroljub/wikipedia-api-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 

Repository files navigation

Wikipedia API docs

Wikipedia API examples. For advanced usage see Official Mediawiki API documentation

Quick intro:

  • All client requests should contain &origin=* because of CORS.
  • Search term should be capitalize (Tori Amos not tori amos) if multiple words.
  • You could request any wiki language you like (for example: sh.wikipedia.org or de.wikipedia.org)

Table of content

Articles

Get an article

GET full article for the requested title (titles=belgrade), with images (pageimages) and article URL (inprop=url). Also, follows redirection (redirects) if necessary:

en.wikipedia.org/w/api.php?action=query&titles=belgrade&prop=extracts|pageimages|info&pithumbsize=400&inprop=url&redirects=&format=json&origin=*

Previous request with minimal params:

en.wikipedia.org/w/api.php?action=query&titles=belgrade&prop=extracts&format=json

GET first paragraph of an article:

en.wikipedia.org/w/api.php?action=query&titles=Belgrade&prop=extracts&format=json&exintro=1

Search articles

To GET first 10 search results with extract and thumbnail image (prop=extracts|pageimages). Results is HTML by default, but we want json format:

en.wikipedia.org/w/api.php?action=query&generator=search&gsrsearch=belgrade&exintro=&prop=extracts|pageimages&format=json

GET first 20 search results (srlimit) with short info (prop=info):

en.wikipedia.org/w/api.php?action=query&list=search&prop=info&inprop=url&utf8=&format=json&srlimit=20&srsearch=belgrade

GET first 20 search results (gsrlimit) with extract and thumbnail image (prop=extracts|pageimages). This time, article extract is set to plain text (explaintext):

en.wikipedia.org/w/api.php?action=query&generator=search&gsrlimit=20&prop=pageimages|extracts&exintro&explaintext&exlimit=max&format=json&gsrsearch=belgrade

Advanced search params:

  • gsrsearch=intitle:belgrade (word "belgrade" is in title)
  • gsrsearch=prefix:belgrade (article's title starts with the word "belgrade")

If you have problems, append &origin=* at the end of the route.

Images

GET the main image

Get source of the main image of the article:

en.wikipedia.org/w/api.php?action=query&titles=Belgrade&prop=pageimages&format=json&pithumbsize=250

GET all images from the article

Get all images from the article:

en.wikipedia.org/w/api.php?action=query&titles=belgrade&prop=images&format=json

Search free images

GET first 20 image files (gsrnamespace=6) from Wikimedia Commons with the term "Belgrade" in the filename (gsrsearch=intitle:Belgrade). Requested thumbnail size is 250px (pithumbsize=250):

commons.wikimedia.org/w/api.php?prop=pageimages|imageinfo|info|redirects&gsrnamespace=6&pilimit=max&pithumbsize=250&iiprop=extmetadata&iiextmetadatafilter=ImageDescription&action=query&inprop=url&redirects=&format=json&generator=search&gsrsearch=intitle:Belgrade&gsrlimit=20

Previous request without some params:

commons.wikimedia.org/w/api.php?prop=pageimages|info|redirects&gsrnamespace=6&pithumbsize=250&action=query&inprop=url&redirects=&format=json&generator=search&gsrsearch=intitle:Belgrade&gsrlimit=20

Remember, if you have problems, append &origin=* at the end of the route.

Quotes

GET wiki quotes for requested term (titles=Zen). The API is the same, just the domain is different (wikiquote.org):

en.wikiquote.org/w/api.php?action=query&titles=Zen&prop=extracts|info&inprop=url&redirects=&format=json

Releases

No releases published

Packages

No packages published