The API Browser

Every prismic.io repository includes an API browser that will help you discover your API, test your queries, and display the JSON results. This is based on our RESTFUL API. Here we will go through the details on how to use the API Browser.

Select a ref

When using the API browser, you first need to select the ref for the query. The ref select box will allow you to select any present or future release which is accessible.

Note that if you're supposed to have access to future releases and you can't see them, you may have to log in. To do that, click on the lock icon in the upper-right corner and this will ask for your credentials to reveal the future release refs.

Choose your form

The form by default is "Everything", which retrieves and allows you to query all your content.

The other available forms are collections that you define in the settings of your repository. A collection allows you to limit the documents to certain tags or custom types.

In the example below we have a collection for each programming language in our documentation. When you select a collection, this will predefine a predicate to filter the results.

Enter your predicates to query the form

Enter your predicates in the form named "Query." Type out the predicate and press enter to set it. If you need to modify a predicate, simply double-click on it and you will be able to make changes.

To learn more about the specifics of each predicate, check out our Predicates reference page.

Enter your orderings to sort the results

Enter your sorting options in the "Orderings" form. After you've written the ordering, press enter to set it. After that, double-click on the ordering if you need to modify it.

To learn more about how to write the orderings, check out the Order your results page.

Change the result format (HTML or JSON)

The API Browser will provide styled HTML results by default, but you can switch to browsable JSON results. To do this you can click on the HTML / JSON switch at the top of your API Browser.

Refine your query as needed

Launch your query to see what results are retrieved. If your query wasn't exactly what you were looking for, reopen the query form and change your query. Then repeat the process as needed!