Atlas Obscura Unofficial API

A simple Flask-RESTful api for Atlas Obscura.
Hosted on Heroku here.

From the wikipedia page:

Atlas Obscura is an online magazine and digital media company led by American journalist David Plotz.

It catalogs unusual and obscure travel destinations, and relies heavily on user-generated content. It features a mixture of feature and news articles on topics including history, science and some news, in addition to travel and exploration, as well as hosting a collaborative "guide" to the world's most obscure places.

API Documentation

What's new in this version?

• Added endpoints for Gastro Obscura, a spinoff of Atlas Obscura for cuisine and restaurants.
• Added query parameter to filter by U.S. state.

Base URL

https://atlas-obscura-api.herokuapp.com

Destinations

Use this endpoint to get a list of all destinations (countries) on Atlas Obscura.

/api/atlas/destinations

Parameters

Sample Response

GET https://atlas-obscura-api.herokuapp.com/api/atlas/destinations?region=Central-America

{
  status: "success",
  results: 6,
  region: "Central America",
  destinations: ["Belize", "Costa Rica", "Guatemala", "Honduras", "Nicaragua", "Panama"]
}

Attractions

Use this endpoint to get a list of attractions in a particular country or city.

/api/atlas/attractions/<country>

Parameters

Sample Response

GET https://atlas-obscura-api.herokuapp.com/api/atlas/attractions/japan?city=tokyo&sort=recent&limit=3

{
  status: "success",
  results: 3,
  attractions: [
    {
      name: "Intermediatheque",
      location: "Tokyo, Japan",
      description: "An unexpected curiosity cabinet hidden within a department store in the Japan Post tower.",
      coordinates: [35.6798, 139.7645],
      img: "https://assets.atlasobscura.com/media/...",
      path: "/places/intermediatheque"
    },
    {
      name: "Owl Police Box",
      location: "Tokyo, Japan",
      description: "This adorable birdlike police box is designed based on a play on words.",
      coordinates: [35.7297, 139.7129],
      img: "https://assets.atlasobscura.com/media/...",
      path: "/places/owl-police-box-ikebukuro-station"
    },
    {
      name: "Myth of Tomorrow",
      location: "Tokyo, Japan",
      description: "After being lost for decades, this striking mural depicting the atomic bomb covers the wall...",
      coordinates: [35.658, 139.7016],
      img: "https://assets.atlasobscura.com/media/...",
      path: "/places/myth-of-tomorrow"
    }
  ]
}

Unique Food & Drink

Use these endpoints to get a list of cuisines of a particular country or city.

/api/gastro/food-and-drink

Parameters

/api/gastro/food-and-drink/<country>

Parameters

Sample Response

GET https://atlas-obscura-api.herokuapp.com/api/gastro/food-and-drink/south-korea?limit=2

{
  status: "success",
  results: 2,
  unique-food-and-drink: [
    {
      category: "Sweets",
      name: "Dragon's Beard Candy",
      region: "South-Korea",
      description: "The ancient confection consists of wispy sugar-strands that look like dragon whiskers.",
      img: "https://assets.atlasobscura.com/media/...",
      path: "/foods/dragons-beard-candy-china"
    },
    {
      category: "Drinks",
      name: "Makgeolli",
      region: "South-Korea",
      description: "South Korea's oldest alcoholic beverage is making a comeback.",
      img: "https://assets.atlasobscura.com/media/...",
      path: "/foods/makgeolli-south-korea"
    }
  ]
}

Gastro Places

Use this endpoint to return Gastro Obscura places and restaurants.

/api/gastro/places

Parameters

Sample Response

GET https://atlas-obscura-api.herokuapp.com/api/gastro/places?limit=2

{
  status: "success",
  results: 2,
  Gastro-Places: [
    {
      location: "Savannah, Georgia",
      name: "The Pirates' House",
      description: "This kitschy tavern is also home to rare early editions of \"Treasure Island.\"",
      coordinates: [32.0781, -81.0839],
      img: "https://assets.atlasobscura.com/media/...",
      path: "/places/the-pirates-house"},
    {
      location: "Lisbon, Portugal",
      name: "Conserveira de Lisboa",
      description: "The best place in the world to buy canned fish. ",
      coordinates: [38.7093, -9.1347],
      img: "https://assets.atlasobscura.com/media/...",
      path: "/places/conserveira-de-lisboa"
    }
  ]
}