The Rest API Browser

Every Prismic repository includes an API Browser to 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.

To learn how to use the Prismic API with your chosen technology, see our technologies guides:

To learn more about the Rest API itself, see our API documentation:

Here is the url for your repository's API Browser:

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

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 specific 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 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 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.

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.

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!

Once you're satisfied with how your queries are defined, you may wish to have the direct JSON formatted response from the API. In that case you can include 'cdn' to your endpoint address and get the direct API response.

When Querying the API Browser, you can add query parameters after the “ref” parameter and before the hashtag (#) in the URL to get filtered results based upon the parameters described in the Search parameter Reference.

For instance, if the API Browser URL is:

Then, to get a page with only one result, add the pageSize parameter:

And if there is a need to add more than one query parameter, it can be done by adding ‘&’ before each query parameter. for example, getting 2 results (parameter : page size=2) and starting from page 3 (parameter : page=3):