feeds.snocountry.netSnoCountry Conditions and Profiles Feed API

Get Started API Request Parameters Levels & Field Definitions SnoCountry Conditions JSON API Documentation Get Started - API Key: how to get snow reports In order to retrieve data a developer must purchase a key from SnoCountry. To get a key please contact Andrew Davis @ 603-443-8823 . Sample apiKey You can utilize the key ( SnoCountry.example ) to view the SnoCountry JSON API in action and or facilitate development. The key ( SnoCountry.example ), combined with other valid request parameters, returns up to 3 resorts . http://feeds.snocountry.net/getSnowReport.php? apiKey=SnoCountry.example &states=vt link General Guidelines In general snow conditions are updated throughout the day, as snow reports come in from the ski areas. With that in mind, we recommend developers follow these guidelines when making requests: Developers who will cache results in a database. Single ski area condition requests have no limitation. Documentation can be seen here . Single State condition requests have no limitation. Documentation can be seen here . Region requests should not be made every few seconds. We recommend if you make a region request, e.g. USA,Europe,Canada, the subsequent region request should be 10 - 15 mins later. Documentation can be seen here . Developers who will request conditions directly from their app. e.g.: mobile apps. Single ski area condition requests have no limitation. Documentation can be seen here . Single State condition requests have no limitation. Documentation can be seen here . Regional ski area condition requests, from a mobile app we do not allow. API End points getSnowReport: Retrieves daily dynamic conditions for ski resorts. This will be the normal request for most users. http://feeds.snocountry.net/ getSnowReport .php?apiKey=SnoCountry.example&states=vt link getResortList: Retrieves list of resorts (id, name, state, country,region,resortType) in HTML or JSON format JSON Sample: http://feeds.snocountry.net/ getResortList .php?apiKey=SnoCountry.example&states=vt& output=json link HTML Sample: http://feeds.snocountry.net/ getResortList .php?apiKey=SnoCountry.example&states=vt link Request Parameters API Key http://feeds.snocountry.net/getSnowReport.php? apiKey=yourKey &states=vt Sample API Key: http://feeds.snocountry.net/getSnowReport.php? apiKey=SnoCountry.example &states=vt link Regions: The developer can pass one region or multiple regions separated by a comma. Note: Please refrain from requesting all the regions in one request. SnoCountry recommends the developer request "usa" in one request, canada in another, europe in yet another. http://feeds.snocountry.net/getSnowReport.php?apiKey=SnoCountry.example& regions=rockies Rockies Valid Regions: United States regions = {states in that region}: northwest : {AK, ID, OR, WA} southwest : {AZ, CA, NV} rockies : {CO, MT, NM, UT, WY} midwest : {IA, IL, IN, MI, MN, MO, ND, OH, SD, WI} northeast : {CT, MA, ME, NH, NJ, NY, PA, RI, VT} southeast : {AL, GA, MD, NC, TN, VA, WV} usa : {above regions} Other Regions = {countries in that region}: canada : {AB, BC, LB, MB, NF, NS, ON, QC, SK} [LB = Labrador, NF = Newfoundland] europe : {AND, AUT, CHE, CZE , (DEU or GER) , ESP, FIN, FRA, GBR, ITA, LIE, NOR, POL, SVK SWE } southern_hemisphere: {ARG, AUS, CHI, NZL} States: The developer can pass one state or multiple states separated by a comma Valid States: http://feeds.snocountry.net/getSnowReport.php?apiKey=SnoCountry.example& states=co Colorado United States = {states in that region}: northwest : {AK, ID, OR, WA} southwest : {AZ, CA, NV} rockies : {CO, MT, NM, UT, WY} midwest : {IA, IL, IN, MI, MN, MO, ND, OH, SD, WI} northeast : {CT, MA, ME, NH, NJ, NY, PA, RI, VT} southeast : {AL, GA, MD, NC, TN, VA, WV} Non United States: (Province or Country Code can be used as state) canada : {AB, BC, LB, MB, NF, NS, ON, QC, SK} [LB = Labrador, NF = Newfoundland] europe : {AND, AUT, (CHE or SUI), CZE , (DEU or GER) , ESP, FRA, GBR, ITA, LIE, NOR, POL, SVK SWE } southern_hemisphere: {ARG, AUS, CHI, NZL} Resort Ids: The developer can pass one id or multiple ids separated by a comma. To get resort ids utilize getResortList endpoint. http://feeds.snocountry.net/getSnowReport.php?apiKey=SnoCountry.example& ids=505001 Angel Fire Top 20 snowfall: To retrieve the resorts with the highest amount of snowfall in newSnowMin/newSnowMax add the parameter action=top20 . http://feeds.snocountry.net/getSnowReport.php?apiKey=SnoCountry.example®ions=rockies& action=top20 Top 20 in the Rockies Fields returned "id" :(numeric) Unique SnoCountry identifier for resort "resortName" :(text) Name of Resort "state" :(text) Two letter state abbr. "reportDateTime" :(text) Date/Time of Report Format: YYYY-MM-DD HH:ii:ss e.g.: "2010-04-04 11:29:00" "resortType":(text) Possible Values: "NA_Alpine" : North American Alpine "XC" : Cross Country "Intl" : International "newSnowMin" :(numeric) Minimum new snow in last 24 hours, unit=inches "newSnowMax" :(numeric) Maximum new snow in last 24 hours, unit=inches "avgBaseDepthMin" :(numeric) Minimum Average Base Depth , unit=inches "avgBaseDepthMax" :(numeric) Maximum Average Base Depth , unit=inches Notes: The result will be up to 20 resorts , based on snow reported. Hence the # of resorts returned will range from 0 - 20. If no resortType specified (Alpine or XC), see above , default will be All . Hence Top20 will consist of Alpine & XC resorts. The parameters regions & states still apply. Hence you can limit the Top 20 snowfall to a state or region. If no state or region is specified, it will be for the entire WORLD. Levels and Field definitions Green Circle fields: "id" :(numeric) Unique SnoCountry identifier for resort "resortName" :(text) Name of Resort "state" :(text) Two letter state abbr. "country" :(text) Three letter country abbreviation (ISO 3166-1 alpha-3) "reportDateTime" :(text) Date/Time of Report Format: YYYY-MM-DD HH:ii:ss e.g.: "2010-04-04 11:29:00" "resortStatus" :(numeric) Status of ski area Possible values follow: value | Meaning (OperatingStatus value) | Further explanation1 : "Open" = Resort is open 2 : "ReOpen MM/dd or TBA" = Resort is open on certain days (dd : day, MM: Month) 3 : "No Recent/Current Info" = Resort is open but no updates within 3 days 4 : "Operating no details" = Resort can be open/closed no information available 5 : "Plan To Open MM/dd" = (dd : day, MM: Month) 6 : "Opening Soon for Snow Sports" = Resort is closed, Used when Season about to start but no Plan to Open date available. 7 : "Closed" = Resort is closed 8 : "Summer" = Resort is open for summer operations (mountain biking, lift rides...) "newSnowMin" :(numeric) Minimum new snow in last 24 hours, unit=inches "newSnowMax" :(numeric) Maximum new snow in last 24 hours, unit=inches "avgBaseDepthMin" :(numeric) Minimum Average Base Depth , unit=inches "avgBaseDepthMax" :(numeric) Maximum Average Base Depth , unit=inches "openDownHillTrails":(numeric) "openDownHillLifts" :(numeric) "openDownHillMiles" :(numeric) "openDownHillAcres" :(numeric) "openDownHillPercent":(numeric) "maxOpenDownHillTrails":(numeric) Max Open Down Hill Trails "maxOpenDownHillLifts" :(numeric) Max Open Down Hill Lifts "maxOpenDownHillAcres" :(numeric) Max Open Down Hill Acres "maxOpenDownHillMiles" :(numeric) Max Open Down Hill Miles "weekdayHours" :(text) e.g. : "M-F: 9a-5p" "weekendHours" :(text) e.g. : "Sat-Sun: 9a-5p" "snowComments" :(text) e.g. : "18 inches past 72 hours" "snowLast48Hours" :(text) new snow in last 48 hours, unit=inches Field can be a range (13-15) or numeric value (10) "Parks-n-Pipes" :(text) e.g.: "Halfpipe Open, Last Cut: mm/dd/yyyy ..." "Parks-n-Pipes-Available" :(text) "Yes" or "No" "nightSkiing" :(text) Values: Yes/No/"":blank "operatingStatus" :(text) Possible values: "" : Blank - resort is open. primarySurfaceCondition will have value...