API:Protectedtitles

This page is part of the MediaWiki action API documentation.

MediaWiki APIsAPI:Main page

• Web APIs showcaseAPI:Web APIs hub
• REST content API

MediaWiki action API

• Introduction and quick startAPI:Main page
• FAQAPI:FAQ
  • Etiquette and usage limitsAPI:Etiquette
• TutorialAPI:Tutorial
• FormatsAPI:Data formats
• Error reportingAPI:Errors and warnings
• Restricting usageAPI:Restricting API usage
• Cross-site requestsAPI:Cross-site requests
• Authentication
  • LoginAPI:Login
  • LogoutAPI:Logout
  • Account creationAPI:Account creation
• QueriesAPI:Query
  • Meta informationAPI:Meta
  • PropertiesAPI:Properties
  • ListsAPI:Lists
• Searching (by title, content, coordinates...)API:Search and discovery
• Parsing wikitext and expanding templatesAPI:Parsing wikitext
• Purging pages' cachesAPI:Purge
• Parameter informationAPI:Parameter information
• Changing wiki contentAPI:Changing wiki content
  • Create and edit pagesAPI:Edit
  • Move pagesAPI:Move
  • RollbackAPI:Rollback
  • Delete pagesAPI:Delete
  • Restore deleted revisionsAPI:Undelete
  • (Un)protect pagesAPI:Protect
  • (Un)block usersAPI:Block
  • (Un)watch pagesAPI:Watch
  • Mark revisions of watched pages as visitedAPI:SetNotificationTimestamp
  • Send emailAPI:Email
  • Patrol changesAPI:Patrol
  • Import pagesAPI:Import
  • Change user group membershipAPI:User group membership
  • Upload filesAPI:Upload
  • User optionsAPI:Options
  • TokensAPI:Tokens
  • Page languageAPI:PageLanguage
• Watchlist feedAPI:Watchlist feed
• WikidataWikibase/API
• ExtensionsAPI:Extensions
• Using the API in MediaWiki and extensionsAPI:Calling internally
• MiscellaneousAPI:Other services
• ImplementationAPI:Implementation Strategy
  • LocalisationAPI:Localisation
• Client codeAPI:Client code
• AssertingAPI:Assert

Protectedtitles
This module can be used as a GeneratorAPI:generator.
Prefix	pt
Required rights	none
Post only?	No
Generated help	Current
Version added	≥ 1.15

Get a list of titles protected from creation.

Parameters

• ptnamespace: Only list titles in these namespaces Type: namespace (pipe-separated)
• ptlevel: Only list titles with this protection level Type: string (pipe-separated)
• ptlimit: Maximum number of titles to return No more than 500 (5000 for bots) allowed. (Default: 10)
• ptdir: Direction to list in. (Default: older)
  • older: List most recently protected titles first. Note: ptstart must be later than ptend.
  • newer: List least recently protected titles first. Note: ptstart must be earlier than ptend.
• ptstart: Start listing at this protection timestamp
• ptend: End listing at this protection timestamp
• ptprop: A pipe-separated list of properties to get. (Default: timestamp|level)
  • timestamp: Timestamp the title was protected
  • user: User who protected the title
  • userid: User id who protected the title 1.17+
  • comment: Protection log comment
  • parsedcomment: Parsed protection log comment 1.16+
  • expiry: Expiry timestamp
  • level: Protection level (i.e. the right needed to be able to create the page)
• continue: When more results are available, use this to continue 1.23+

Example

Get the first 2 titles only sysops can create

api.php?action=query&list=protectedtitles&ptlevel=sysop&ptlimit=2 [try in ApiSandbox]

Error Codes

None