openapi-directory/api/lotadata.com.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"description":"Access the most exhaustive, accurate and up-to-date collection of global and hyper-local geocoded events and activities across a wide range of categories and genres","title":"LotaData","version":"2.0.0","x-apisguru-categories":["location"],"x-logo":{"backgroundColor":"#FFFFFF","url":"https://pbs.twimg.com/profile_images/664666044754079744/OtP5eqwm_400x400.png"},"x-origin":[{"format":"swagger","url":"https://developers.lotadata.com/swagger/spec/apiv2.json","version":"2.0"}],"x-providerName":"lotadata.com"},"security":[{"api_key":[]}],"paths":{"/events":{"get":{"parameters":[{"description":"List of required EventCategory ids (Tier 1)","in":"query","name":"category","explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"List of required activity type ids (compliment to category)","in":"query","name":"activity","schema":{"type":"string"}},{"description":"List of required ambience ids","in":"query","name":"ambience","schema":{"type":"string"}},{"description":"List of required genre ids","in":"query","name":"genre","schema":{"type":"string"}},{"description":"Matching on event and place names","in":"query","name":"name","schema":{"type":"string"}},{"description":"Text query matching titles, description, various text, tags, category","in":"query","name":"q","schema":{"type":"string"}},{"description":"Start on or after date specified (2015-10-16)","in":"query","name":"from_day","required":false,"schema":{"type":"string"}},{"description":"Start on or before date specified (2015-10-16)","in":"query","name":"to_day","required":false,"schema":{"type":"string"}},{"description":"Min capacity at location","in":"query","name":"capacity_min","required":false,"schema":{"type":"number","format":"integer"}},{"description":"Min capacity at location","in":"query","name":"capacity_max","required":false,"schema":{"type":"number","format":"integer"}},{"description":"latitude,longitude of the origin point","in":"query","name":"center","schema":{"type":"string"}},{"description":"Distance from origin in meters","in":"query","name":"radius","schema":{"type":"integer"}},{"description":"Corner of a bounding box (lat,lng). Requires 0 or 2 pairs","in":"query","name":"bbox","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Closed custom polygon. Ordered list of lat,lng pairs","in":"query","name":"polygon","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Search within specified geopolitical place id","in":"query","name":"within","required":false,"schema":{"type":"string"}},{"description":"Return results starting at specified offset","in":"query","name":"offset","schema":{"type":"integer"}},{"description":"Max results to return","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Return results starting at specified offset (summary, context, detail)","in":"query","name":"fieldset","required":true,"schema":{"type":"string","enum":["summary","detail","context","minicontext"],"default":"context"}}],"responses":{"200":{"description":"List of matching events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventsSearchResponse"}}}},"400":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"summary":"Find event occurrences in the area. Returns results at specific place and time, event groups are expanded for every occurrence.","tags":["Events"]}},"/events/{id}":{"get":{"parameters":[{"description":"event @id","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"fieldset","schema":{"type":"string","enum":["summary","detail","context","minicontext"],"default":"summary"}}],"responses":{"200":{"description":"Requested event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventOccurenceDetail"}}}},"404":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"summary":"Get Specific event details.","tags":["Events"]}},"/places":{"get":{"parameters":[{"description":"List of required PlaceCategory ids (Tier 1)","in":"query","name":"category","explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"List of required PlaceFunction ids (Tier 2)","in":"query","name":"function","explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"List of required ambience ids","in":"query","name":"ambience","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"List of required tags","in":"query","name":"tag","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Specific PlaceType to return","in":"query","name":"type","schema":{"type":"string"}},{"description":"Match on place names","in":"query","name":"name","schema":{"type":"string"}},{"description":"Require an exact name match","in":"query","name":"exact","schema":{"type":"boolean"}},{"description":"Min capacity at location","in":"query","name":"capacity_min","required":false,"schema":{"type":"number","format":"integer"}},{"description":"Min capacity at location","in":"query","name":"capacity_max","required":false,"schema":{"type":"number","format":"integer"}},{"description":"Address of the place or street component of the address","in":"query","name":"street","schema":{"type":"string"}},{"description":"city, town, or neighborhood of the place","in":"query","name":"locality","schema":{"type":"string"}},{"description":"region or state","in":"query","name":"region","schema":{"type":"string"}},{"description":"Postal or zip code","in":"query","name":"postal_code","schema":{"type":"string"}},{"description":"country component of the address","in":"query","name":"country","schema":{"type":"string"}},{"description":"latitude,longitude of the origin point","in":"query","name":"center","schema":{"type":"string"}},{"description":"Distance from origin in meters","in":"query","name":"radius","schema":{"type":"integer"}},{"description":"Corner of a bounding box (lat,lng). Requires 0 or 2 pairs","in":"query","name":"bbox","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Closed custom polygon. Ordered list of lat,lng pairs","in":"query","name":"polygon","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Search within specified geopolitical place id","in":"query","name":"within","required":false,"schema":{"type":"string"}},{"description":"Return results starting at specified offset","in":"query","name":"offset","schema":{"type":"integer"}},{"description":"Max results to return","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Return results starting at specified offset (summary, context, detail)","in":"query","name":"fieldset","required":true,"schema":{"type":"string","enum":["summary","detail","context"],"default":"context"}}],"responses":{"200":{"description":"List of matching events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlacesSearchResponse"}}}},"400":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"summary":"Venues, landmarks, regions, these are all places to search.","tags":["Places"]}},"/places/{id}":{"get":{"parameters":[{"description":"place @id","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"fieldset","schema":{"type":"string","enum":["summary","detail","context","minicontext"],"default":"summary"}}],"responses":{"200":{"description":"Requested place","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceDetail"}}}},"404":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"summary":"Get specific place details","tags":["Places"]}}},"servers":[{"url":"https://api2.lotadata.com/v2"}],"components":{"securitySchemes":{"api_key":{"description":"Your API key","in":"query","name":"api_key","type":"apiKey"}},"schemas":{"Address":{"description":"Physical world addresss","properties":{"country":{"type":"string"},"formatted":{"description":"Address formatted for display as a single string","type":"string"},"locality":{"description":"City or town","type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"},"street":{"description":"Street portion of the address, may sometimes be a common name of the place","type":"string"},"unit":{"type":"string"}}},"ContactDetail":{"properties":{"displayPhone":{"type":"string"},"email":{"type":"string"},"facebookUrl":{"type":"string"},"instagramName":{"type":"string"},"lastfmUrl":{"type":"string"},"soundcloudUrl":{"type":"string"},"spotifyUrl":{"type":"string"},"twitterName":{"type":"string"},"url":{"type":"string"},"youtubeUrl":{"type":"string"}}},"Error":{"properties":{"cause":{"properties":{"expected":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"value":{"type":"string"}}},"message":{"type":"string"},"status":{"format":"int32","type":"integer"},"tracking":{"properties":{"id":{"type":"string"},"session":{"type":"string"}}}}},"EventOccurenceDetail":{"description":"Event Occurrence Detail limited to requested fieldset.","properties":{"@id":{"description":"Unique event id","type":"string"},"@type":{"description":"Type of occurrence. You will usually see Organized as the type for most events. While Virtual events will get their own Virtual type.","enum":["Organized","Screening","Environmental","Virtual"],"type":"string"},"activity":{"description":"Associated ActivityType entries","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"ambience":{"description":"expected mood and feel of the event","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"at":{"$ref":"#/components/schemas/PlaceReference"},"awayTeam":{"$ref":"#/components/schemas/FeatureReference"},"category":{"description":"Associated EventCategory. May be multiple, such as Charity Music event","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"contactPoint":{"$ref":"#/components/schemas/ContactDetail"},"description":{"description":"Full description in plain text","type":"string"},"doorTime":{"description":"Time when the admission starts","format":"date-time","type":"string"},"duration":{"description":"Duration of the event in ISO-8601 format (PT45M) - 45 minutes","type":"string"},"endApprox":{"description":"endDate is approximated based on historical data","type":"boolean"},"endDate":{"description":"Time when the event ends, if known","format":"date-time","type":"string"},"extTaxonomy":{"description":"extended taxonomy such as IAB and Google AdWords","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"genre":{"description":"applicable Genres. (Tier 2 taxonomy). May include related genres from categories, not deemed as primary","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"headline":{"description":"Optional short description in plain text","type":"string"},"homeTeam":{"$ref":"#/components/schemas/FeatureReference"},"htmlDescription":{"description":"Full description with HTML formatting, where available","type":"string"},"image":{"$ref":"#/components/schemas/ImageMeta"},"inLanguage":{"$ref":"#/components/schemas/FeatureReference"},"name":{"description":"Name of the event in plain text","type":"string"},"noTime":{"description":"Specific time of the event is unknown. (shown only when true)","type":"boolean"},"offers":{"description":"Ticketing options","items":{"$ref":"#/components/schemas/TicketOffer"},"type":"array"},"onDemand":{"description":"This event can start at any time during specified window","type":"boolean"},"performer":{"description":"List of Personas significant for this event","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"photo":{"description":"Primary image","items":{"$ref":"#/components/schemas/ImageMeta"},"type":"array"},"startDate":{"description":"Time when the event starts","format":"date-time","type":"string"},"superEvent":{"$ref":"#/components/schemas/OccurrenceReference"},"updated":{"description":"Timestamp of last modification (UTC)","format":"date-time","type":"string"},"url":{"description":"Primary url for published event","type":"string"},"workPerformed":{"description":"Subject matter of the event","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"}}},"EventsQuery":{"description":"Specific filters understood and executed for this query. If your parameter is not visible here, then consult the documentation for correct usage.","properties":{"activity":{"description":"required activity types","items":{"type":"string"},"type":"array"},"category":{"description":"required categories","items":{"type":"string"},"type":"array"},"limit":{"description":"maximum number of matches to return","type":"integer"}}},"EventsSearchResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventOccurenceDetail"},"type":"array"},"query":{"$ref":"#/components/schemas/EventsQuery"},"stats":{"$ref":"#/components/schemas/SearchStatsMetaResult"}}},"FeatureReference":{"description":"Identifier for a Feature","properties":{"@id":{"description":"Feature id","type":"string"},"@type":{"description":"Type of specific feature or Taxonomy node such as EventCategory, SportsTeam, Persona.","type":"string"},"name":{"description":"Display name of the feature","type":"string"}}},"GeoJsonObject":{"description":"Shape defined per GeoJSON spec"},"GeoPt":{"properties":{"lat":{"type":"number"},"lon":{"type":"number"}}},"ImageMeta":{"description":"Image meta data","properties":{"@id":{"type":"string"},"caption":{"type":"string"},"height":{"type":"integer"},"url":{"type":"string"},"width":{"type":"integer"}}},"OccurrenceReference":{"properties":{"@id":{"type":"string"},"name":{"type":"string"},"startDate":{"description":"Time when the event starts","format":"date-time","type":"string"}}},"PlaceDetail":{"allOf":[{"$ref":"#/components/schemas/PlaceReference"}],"properties":{"ambience":{"description":"expected mood and feel of the event","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"category":{"description":"Associated PlaceCategory. May be multiple (Tier 1)","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"contact":{"$ref":"#/components/schemas/ContactDetail"},"function":{"description":"PlaceFunction. (Tier 2 taxonomy)","items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"},"openingHours":{"items":{"$ref":"#/components/schemas/Timeframe"},"type":"array"},"photo":{"items":{"$ref":"#/components/schemas/ImageMeta"},"type":"array"}}},"PlaceReference":{"description":"Unique Location","properties":{"@id":{"type":"string"},"@type":{"description":"Type of place where Place is a physical address, LocalBusiness is any type of comercial property, AdministrativeArea is a political or colloquial area, and Virtual is out of this world","enum":["Place","LocalBusiness","AdministrativeArea","TouristAttraction","Landform","LandmarksOrHistoricalBuildings","Residence","Virtual"],"type":"string"},"address":{"$ref":"#/components/schemas/Address"},"geo":{"$ref":"#/components/schemas/GeoPt"},"geometry":{"$ref":"#/components/schemas/GeoJsonObject"},"location":{"$ref":"#/components/schemas/VirtualLocation"},"logo":{"$ref":"#/components/schemas/ImageMeta"},"name":{"type":"string"},"tag":{"items":{"$ref":"#/components/schemas/FeatureReference"},"type":"array"}}},"PlacesQuery":{"description":"Specific filters understood and executed for this query. If your parameter is not visible here, then consult the documentation for correct usage.","properties":{"address":{"$ref":"#/components/schemas/Address"},"category":{"description":"required categories","items":{"type":"string"},"type":"array"},"limit":{"description":"maximum number of matches to return","type":"integer"}}},"PlacesSearchResponse":{"properties":{"places":{"items":{"$ref":"#/components/schemas/PlaceDetail"},"type":"array"},"query":{"$ref":"#/components/schemas/PlacesQuery"},"stats":{"$ref":"#/components/schemas/SearchStatsMetaResult"}}},"SearchStatsMetaResult":{"description":"Shows invocation details about the query. Running query again, could produce different results","properties":{"count":{"description":"Total matches for the query","type":"integer"},"fieldset":{"description":"Specific fields returned by this query","type":"string"},"runtime":{"description":"Server side run time in msec for this request","type":"integer"}}},"TicketOffer":{"properties":{"availability":{"enum":["Discontinued","InStock","InStoreOnly","LimitedAvailability","OnlineOnly","OutOfStock","PreOrder","SoldOut"],"type":"string"},"category":{"enum":["primary","secondary","presale","member","premium","unknown"],"type":"string"},"donation":{"type":"boolean"},"fee":{"type":"number"},"highPrice":{"type":"number"},"inventory":{"properties":{"available":{"type":"integer"},"total":{"type":"integer"}},"type":"object"},"name":{"type":"string"},"price":{"type":"number"},"priceCurrency":{"type":"string"},"priceUnknown":{"type":"boolean"},"url":{"type":"string"}}},"Timeframe":{"properties":{"closes":{"description":"Close time for all days mentioned in the dayOfWeek. If close time is less than open, then it is following day.","format":"date-time","type":"string"},"dayOfWeek":{"description":"ISO day of the week. 1- Monday, 7- Sunday","items":{"type":"integer"},"type":"array"},"open247":{"description":"Open around the clock","type":"boolean"},"opens":{"description":"Open time for all days mentioned in the dayOfWeek","format":"date-time","type":"string"}}},"VirtualLocation":{"description":"Virtual Address","properties":{"domain":{"type":"string"},"platform":{"type":"string"},"url":{"type":"string"}}}}}}