{ "openapi": "3.1.0", "info": { "title": "Attractions API", "version": "1.0.0", "description": "63,938 tourist attractions worldwide with coordinates, Wikipedia articles and 51,500 Commons photos, CC0.\n\nTourist attractions worldwide with licensing you can build on: 63,938 places across 13 curated categories — museums, castles, palaces, monuments, cathedrals, zoos, aquariums, amusement parks, botanical gardens, national parks, archaeological sites, lighthouses and observation towers — every one with an English Wikipedia article AND coordinates, from Wikidata (CC0). 51,500 come with a Wikimedia Commons photo URL ready for your cards; 516 carry the UNESCO World Heritage flag; annual visitor counts appear where recorded (the Louvre: 2.8 million). The nearby endpoint is a one-call itinerary builder — 5 km around central Paris returns Notre-Dame at 0.4 km, the Louvre at 1.3 and the Eiffel Tower at 4.2, famous-first. Search is token full-text (\"statue of liberty\" just works) with type, country, city and UNESCO filters: 550 German castles led by Hohenschwangau, 69 US national parks led by Yellowstone and Yosemite. Built for travel and itinerary apps, hotel and tour products, city guides, mapping and games. CC0 source data, self-hosted — no third-party calls at request time.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/attractions.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/attractions" }, "servers": [ { "url": "https://api-attractions.dataandapis.com" } ], "tags": [ { "name": "Lifestyle", "description": "Attractions API belongs to the Lifestyle category of the Data and APIs catalog." } ], "paths": { "/v1/attractions/nearby": { "get": { "operationId": "attractionsNearAPoint", "summary": "Attractions Near A Point", "description": "Attractions Near A Point endpoint of the Attractions API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/attractions/attractions-near-a-point" }, "parameters": [ { "name": "lat", "in": "query", "required": true, "schema": { "type": "string" }, "example": "48.8566" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "25" }, { "name": "lon", "in": "query", "required": true, "schema": { "type": "string" }, "example": "2.3522" }, { "name": "radius", "in": "query", "required": false, "schema": { "type": "string" }, "example": "5" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "example": "museum" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "lat": 48.8566, "lon": 2.3522, "radius_km": 5, "count": 5, "results": [ { "qid": "Q19675", "name": "Louvre Museum", "description": "art and archeology museum in Paris, France", "type": "museum", "city": "Saint-Germain-l'Auxerrois", "country": "France", "latitude": 48.86111, "longitude": 2.33583, "unesco_world_heritage": false, "visitors_per_year": 2825000, "opened_year": 1793, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Cour%20Napol%C3%A9on%20at%20night%20-%20Louvre.jpg?width=640", "website": "https://www.louvre.fr/zh-hans", "wikipedia": "https://en.wikipedia.org/wiki/Louvre", "notability_rank": 169, "distance_km": 1.3 }, { "qid": "Q23402", "name": "Musée d'Orsay", "description": "art museum in Paris, France", "type": "museum", "city": "7th arrondissement of Paris", "country": "France", "latitude": 48.85997, "longitude": 2.32653, "unesco_world_heritage": false, "visitors_per_year": 1044365, "opened_year": 1986, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Gare%20d%27Orsay%20%2849570190081%29.jpg?width=640", "website": "https://www.musee-orsay.fr", "wikipedia": "https://en.wikipedia.org/wiki/Mus%C3%A9e_d'Orsay", "notability_rank": 122, "distance_km": 1.9 }, { "qid": "Q178065", "name": "Centre Georges Pompidou", "description": "national cultural center of contemporary art in Paris, France", "type": "museum", "city": "Quartier Saint-Merri", "country": "France", "latitude": 48.86064, "longitude": 2.35224, "unesco_world_heritage": false, "visitors_per_year": 3273867, "opened_year": 1977, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Paris%20Montmartre%20Blick%20aufs%20Centre%20Georges-Pompidou.jpg?width=640", "website": "https://www.centrepompidou.fr/en/", "wikipedia": "https://en.wikipedia.org/wiki/Centre_Pompidou", "notability_rank": 63, "distance_km": 0.4 }, { "qid": "Q1538826", "name": "Musée des Arts et Métiers", "description": "science and technology museum located in Paris, France", "type": "museum", "city": "3rd arrondissement of Paris", "country": "France", "latitude": 48.86611, "longitude": 2.35528, "unesco_world_heritage": false, "visitors_per_year": 367902, "opened_year": 1794, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Mus%C3%A9e%20des%20Arts%20et%20M%C3%A9tiers%20337.jpg?width=640", "website": "https://www.arts-et-metiers.net", "wikipedia": "https://en.wikipedia.org/wiki/Mus%C3%A9e_des_Arts_et_M%C3%A9tiers", "notability_rank": 53, "distance_km": 1.1 }, { "qid": "Q820892", "name": "Petit Palais", "description": "building housing the Museum of Fine Arts of the City of Paris", "type": "museum", "city": "8th arrondissement of Paris", "country": "France", "latitude": 48.86603, "longitude": 2.31456, "unesco_world_heritage": false, "visitors_per_year": 1000000, "opened_year": 1902, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Petit%20Palais%20Paris%202.jpg?width=640", "website": "http://www.petitpalais.paris.fr", "wikipedia": "https://en.wikipedia.org/wiki/Petit_Palais", "notability_rank": 47, "distance_km": 2.9 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Attractions API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/attractions/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "attribution": "Data from Wikidata (CC0); images via Wikimedia Commons (licences vary per file — see the Commons page)", "count": 1, "sources": [ { "slug": "wikidata-attractions", "name": "Wikidata tourist attractions (13 classes, enwiki+coords)", "publisher": "Wikidata contributors", "licence": "CC0 1.0 (public domain dedication)", "source_url": "https://www.wikidata.org/", "file_url": "https://query.wikidata.org/sparql", "cadence": "periodic full re-harvest", "record_count": 63938, "retrieved_at": "2026-09-06" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/attractions/{qid}": { "get": { "operationId": "getAttraction", "summary": "Get Attraction", "description": "Get Attraction endpoint of the Attractions API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/attractions/get-attraction" }, "parameters": [ { "name": "qid", "in": "path", "required": true, "schema": { "type": "string" }, "example": "Q19675" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "attraction": { "qid": "Q19675", "name": "Louvre Museum", "description": "art and archeology museum in Paris, France", "type": "museum", "city": "Saint-Germain-l'Auxerrois", "country": "France", "latitude": 48.86111, "longitude": 2.33583, "unesco_world_heritage": false, "visitors_per_year": 2825000, "opened_year": 1793, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Cour%20Napol%C3%A9on%20at%20night%20-%20Louvre.jpg?width=640", "website": "https://www.louvre.fr/zh-hans", "wikipedia": "https://en.wikipedia.org/wiki/Louvre", "notability_rank": 169 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/attractions/random": { "get": { "operationId": "randomAttraction", "summary": "Random Attraction", "description": "Random Attraction endpoint of the Attractions API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/attractions/random-attraction" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "attraction": { "qid": "Q1323932", "name": "Istana Nurul Iman", "description": "palace of Sultan of Brunei", "type": "palace", "city": "Bandar Seri Begawan", "country": "Brunei", "latitude": 4.87203, "longitude": 114.92076, "unesco_world_heritage": false, "visitors_per_year": null, "opened_year": 1984, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Istana-nurul-iman.jpg?width=640", "website": "http://www.istananuruliman.org/", "wikipedia": "https://en.wikipedia.org/wiki/Istana_Nurul_Iman", "notability_rank": 27 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/attractions": { "get": { "operationId": "searchAttractions", "summary": "Search Attractions", "description": "Search Attractions endpoint of the Attractions API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/attractions/search-attractions" }, "parameters": [ { "name": "city", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "statue of liberty" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "unesco", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 6, "page": 1, "limit": 20, "count": 3, "results": [ { "qid": "Q9202", "name": "Statue of Liberty", "description": "monument in New York", "type": "monument", "city": "New York City", "country": "United States", "latitude": 40.68921, "longitude": -74.04443, "unesco_world_heritage": true, "visitors_per_year": 3722029, "opened_year": 1886, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Statue%20of%20Liberty%20and%20a%20sightseeing%20boat%2C%20Liberty%20Island%2C%20New%20York.jpg?width=640", "website": "http://www.nps.gov/stli/index.htm", "wikipedia": "https://en.wikipedia.org/wiki/Statue_of_Liberty", "notability_rank": 157 }, { "qid": "Q359939", "name": "Statue of Liberty National Monument", "description": "United States national monument", "type": "monument", "city": "Jersey City", "country": "United States", "latitude": 40.6942, "longitude": -74.0431, "unesco_world_heritage": false, "visitors_per_year": 5509706, "opened_year": 1924, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Liberty%20and%20Ellis%20Island.jpg?width=640", "website": "https://www.nps.gov/stli/index.htm", "wikipedia": "https://en.wikipedia.org/wiki/Statue_of_Liberty_National_Monument", "notability_rank": 10 }, { "qid": "Q17478710", "name": "Finnish Statue of Liberty", "description": "bronze sculpture", "type": "monument", "city": "Vaasa", "country": "Finland", "latitude": 63.09617, "longitude": 21.61556, "unesco_world_heritage": false, "visitors_per_year": null, "opened_year": null, "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Finlands%20frihetsstaty.jpg?width=640", "website": null, "wikipedia": "https://en.wikipedia.org/wiki/Statue_of_Liberty_(Finland)", "notability_rank": 6 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }