Skip to content

Search API

About

The search API allows developers to query against the Utah.gov indexed database. Use this to pull all or any of our various types and categories. The following document outlines sample sample code, parameters, and a type and category legend for making your queries.

All of our APIs are accessible with all server side programming languages. JavaScript requests will not work.

Parameters

Type of Parameter Required Value
keyword none
categoryIds You can pass multiple category IDs, separated by a comma.
typeIds See table below for a complete list of type ids.
limit How many results you'd like to see.

Examples

Sample Query

This query pulls all the CSV files (typeIds 17) that match the category of Environmental Protection (categoryIds 12) and include the keyword "oil" and limits the results to 50.

curl -H "Accept:application/json" "https://www.utah.gov/masterindex/search.json?keyword=oil&typeIds=17&categoryIds=12&limit=50"

Sample Result (jSON)

{
   "results":[
      {
         "agencies":[

         ],
         "categories":[
            "Environmental Protection"
         ],
         "description":"Utah Refinery Receipts of Crude Oil by State of Origin, 1960-2008",
         "governmentClass":"state",
         "imageName":"",
         "name":"Utah Refinery Receipts of Crude Oil",
         "type":"CSV",
         "url":"https://geology.utah.gov/emp/energydata/oildata.htm"
      },
      {
         "agencies":[

         ],
         "categories":[
            "Environmental Protection"
         ],
         "description":"Soil sampling data from across the state of Utah.",
         "governmentClass":"state",
         "imageName":"",
         "name":"Utah Core Research Sample Catalog",
         "type":"CSV",
         "url":"https://geology.utah.gov/emp/ucrc/ucrcfullcatalogue_13Jan09.txt"
      }
   ],
   "topAgency":"Department of Natural Resources",
   "totalCount":2
}

Types

Name ID
Annual Report 75
2013 Annual Reports 77
2014 Annual Reports 77
Data 15
CSV 17
Infographic 69
jSON 52
KMZ 18
SHP 19
TXT 61
XLS 79
XML 16
Form 49
Offline Form 50
Information 4
Blog 7
Tumblr 71
Fact 65
RSS 20
Website 5
Agency Website 63
Wiki 6
Location 83
City 95
City Building 85
County Building 97
Library 89
Park 91
School 87
School District 93
State Park 103
ZIP Code 101
Map 31
ESRI 33
GIS 32
Media 25
Audio Podcast 28
Photos 26
Backgrounds 99
Flickr 42
Instagram 43
Picasa 51
Publications 57
Issuu 55
Scribd 46
Slideshare 30
Soundcloud 47
Video 27
Video (Live) 53
Video Podcast 29
Vimeo 59
YouTube 34
Mobile Apps 12
Mobile (Smartphone) 13
Android 37
Blackberry 38
iPhone 36
Tablet 14
iPad 45
Online Service 1
Application 2
Data Viewer 35
Notification Service 3
Search 48
Social 21
Facebook 24
Google+ 22
LinkedIn 67
Pinterest 44
Twitter 23
Twitter List 73
Trending 54
Widget 8
Flash 10
HTML 9
OSX Dashboard Widget 11

Categories

Name ID
Agriculture and Food Production 2
Business 54
Accommodation, Food Services, and Hotels 137
Administrative and Support and Waste Management 129
Agriculture, Forestry, Fishing, and Hunting 71
Arts, Entertainment, and Recreation 135
Construction 77
Educational Services 131
Finance and Insurance 113
Health Care, Social Assistance, and Hospitals 133
Information - Publishing, Broadcasting, and Telecomm 111
Management of Companies and Enterprises 127
Manufacturing 117
Beverage and Tobacco 81
Chemical 91
Computer and Electronic Products 89
Food 79
Petroleum and Coal Products 85
Plastics and Rubber Products 87
Textiles, Leather, Wood, Paper, Metal, Furniture, and Transportation Equipment 83
Mining, Quarrying, Oil, and Gas Extraction 121
Mining 73
Oil and Gas Extraction 69
Other Services 139
Professional, Scientific, and Technical Services 125
Public Administration 141
Real Estate, Rental, and Leasing 115
Retail Trade 119
Clothing and Clothing Accessory Stores 103
Food and Beverage Stores 97
Gasoline Stations 101
Health and Personal Care Stores 99
Sporting Goods, Hobby, Book, Music, General Merchandise, and Nonstore Retailers 105
Vehicles, Furniture, Electronics, Appliances, and Building Material 95
Transportation and Warehousing 123
Air, Rail, Water, Truck, and Support 107
Postal Service, Couriers, and Messengers 109
Utilities 75
Wholesale Trade 93
Business and Commerce 4
Citizen 52
Community 59
Communications 6
Education 8
Higher Education 57
Public Education 58
Energy and Utilities 10
Environmental Protection 12
Government 14
Legislature 60
Health 16
Hospitals and Medical Care 61
History and Culture 18
Records and Archives 65
Housing and Community Development 20
Human Services and Social Programs 22
Industry and Technology 24
Innovate 145
Jobs, Employment, and Occupations 26
State Government Jobs 67
Laws and Regulations 28
Legal Services and Courts 30
Natural Resources 32
Participate 143
Public Safety and Corrections 34
Purchasing and Finance 63
Recreation and Tourism 36
Taxes and Government Revenu 38
Transportation and Motor Vehicles 40
Voting and Elections 42

Feedback

Was the information on this page helpful?

How can this page be improved?

Back to Top