API Documentation

The Verified Handles API is part of the MediaWiki software.

While only a few can directly edit the database, everyone has read access to nearly all pages.

To get data from Verified Handles visit the API documentation and endpoint at verifiedhandles.com/api.php

A more detailed documentation can be found at mediawiki.org/wiki/Manual:API


The below guide details how data is stored in the Verified Handles Database.

Name

Name for entry is stored in Wikitext in the DisplayTitle tag.
For example, the code {{DISPLAYTITLE:VH Developer}}
Would display the name 'VH Developer' on the entry as as the title of the page.

Description

Always located on the line after DisplayTitle, the about, if not a Wikipedia excerpt, will be in plaintext and may use ''' around words to bold them on the entry.

Socials

Located after
! Icon !! Service !! Username !!
Using {{social|username}} to store the username in relation to the social.

Identifiers

Located after
! Icon !! Database !! Identifier !!
Using {{database|identifier}} to store the identifier in relation to the database.

Subtitle

Found between {{#subtitle: <big> ... </big>}} tags

Querying the API

Use GET requests, see the MediaWiki documentation for examples in popular programming languages.

All requests are logged and developers have exclusive access to identifying information, if you spam the API with unreasonable amounts of requests we will block your IP or query text. If you want to farm data from Verified Handles please contact us so we know to expect high volumes of requests and avoid being blocked.

Internally, we have import files containing raw data for parts of the database. If you would prefer access to raw data files contact us. However, we have no complete data files yet so raw files aren't suitable to complete and up to date access to our data.

All name, subtitle, description (except excerpts from Wikipedia or similar), social and identifier data are in the public domain. Attribution is not required.

About

Designed to combat impersonation, Verified Handles is a non-profit organisation.

Social