Skip to content

alphagov/search-api

Folders and files

NameName
Last commit message
Last commit date
Mar 6, 2025
May 15, 2023
Mar 12, 2025
Jan 21, 2025
Mar 20, 2025
Apr 26, 2016
Jan 6, 2014
Mar 20, 2025
Jan 31, 2024
Feb 7, 2020
Sep 25, 2017
Nov 9, 2021
Nov 21, 2024
Nov 21, 2024
Oct 8, 2024
Mar 21, 2025
Dec 2, 2022
Apr 17, 2019
May 15, 2024
Jan 15, 2021
Mar 14, 2022
Oct 2, 2019
Dec 20, 2011

Repository files navigation

Search API

Search API (née "rummager") indexes content into Elasticsearch and serves the GOV.UK Search API.

GOV.UK applications use the API to search and filter GOV.UK content. For example, alphagov/finder-frontend uses the search API to render site search and finder pages (such as gov.uk/aaib-reports).

Search API also provides a public API: https://www.gov.uk/api/search.json?q=taxes.

Screenshot of API Response

API documentation

If you would like to use the Search API, please see the Search API documentation.

You can also find some examples in the blog post: "Use the search API to get useful information about GOV.UK content".

Technical documentation

Search API is a Sinatra application that interfaces with Elasticsearch.

You can use the GOV.UK Docker environment to run the application and its tests with all the necessary dependencies. Follow the usage instructions to get started.

Use GOV.UK Docker to run any commands that follow.

Running the test suite

bundle exec rake

Additional Docs

Licence

MIT License