On Friday 18 October 2019 Choose from Our List of 11685 Online Newspapers & ePapers to Get Your Daily Newspaper Fix!


Sign up for the Paperboy API


The Paperboy API allows you to access the Paperboy's database of listings for more than 12,000 online newspapers from around the world, to use with your own web site or applications. It employs the simple to use REST framework, returning query results in JSON format. An API key is required to authenticate each request. This is free, just fill out the form at the bottom of this page.

Currently there are two different query methods available. Both return information about newspapers in the defined geographic area.

Method 1: Newspapers by WOEID

WOEID stands for "Where on Earth Identifier" - this is a unique place identifier pioneered by Yahoo GeoPlanet but now used by a number of other services, such as the Twitter API to identify towns, cities and other locations. For more information see this explanation from Yahoo. The Paperboy web site currently uses WOEIDs on all our city listing pages, for example the URL for our London page looks like this: https://www.thepaperboy.com/england/newspapers/london/city.cfm?woeid=44418 As you can see, the WOEID for London is 44418. If you want to find a WOEID for a particular place you can either look up the corresponding Paperboy page or use this handy WOEID lookup tool

Using this method you can return results for all newspapers for a specific WOEID, or with the optional "Distance" attribute, within a certain radius in KM of a particular WOEID.

Required Attributes:
WOEID - A valid WOEID
APIKey - Your unique API Key (sign up on this page)

Optional Attribute:
Distance - An integer - Specify the radius in KM of a particular WOEID you would like to search. If not specified then just results for that particular WOEID are returned. Maximum distance is 100km.

Format for Requests: https://www.thepaperboy.com/api/search/woeid/[WOEID]?apikey=[APIKEY]&distance=[DISTANCE]
Example:https://www.thepaperboy.com/api/search/woeid/44418?apikey=123456789&distance=50

This API request (with a valid API Key) will return results for newspapers published within a 50km radius of London.


Method 2: Newspapers Within X km of Latitude/Longitude

This query returns all newspapers within X km radius of a particular geocoordinate designated by a latitude/longitude pair. Latitude and Longitude should be expressed in decimal format. You can also find lat/long for places using the WOEID lookup tool. To limit the result set, distance is currently capped at 100km and the maximum number of results returned is 100. Results are sorted by City name and the search radius is calculated from the centroid of the WOEID the lat/long pair corresponds to.

Required Attributes:
Latitude and Longitude pair expressed in decimal format i.e value for London is Latitude: 51.51 Longitude: -0.13
A valid WOEID; APIKey - Your unique API Key (sign up on this page)

Optional Attribute:
Distance - An integer - Specify the radius in KM of a particular WOEID you would like to search (max 100km)

Format for Requests: https://www.thepaperboy.com/api/search/coordinates/[LAT]/[LONG]/[DISTANCE]?apikey=[APIKEY]
Example:https://www.thepaperboy.com/api/search/coordinates/51.51/-0.13/50?apikey=123456789

This API request (with a valid API Key) will return results for newspapers published within a 50km radius of London.

The API Returns the Following Columns:

"NAME" (Newspaper Name);
"URL" (Corresponding Page on the Paperboy);
"LANGUAGE" (Language of Publication); "CITY" (City Where Published); "STATE" (State or Province); "COUNTRY";
"LATITUDE";
"LONGITUDE";
"WOEID"

Request/ Recover API key
An API Key is required for every API request. Please fill out the form and we will email you your API key.

Email Address:
Your Website:

Please type what you see (case sensitive):




ThePaperboy.com is not responsible for content on external web sites.
© ThePaperboy.com 1997 - 2019, Australia ABN:91 362 713 390
  Read My Privacy Policy
About Us: Paperboy provides easy access to world and US online newspapers, newspaper obituaries & death notices, local news, front pages, headlines and more.