Build your query URL with Strapi's interactive tool#
A wide range of parameters can be used and combined to query your content with the REST API, which can result in long and complex query URLs.
Strapi's codebase uses to parse and stringify nested JavaScript objects. It's recommended to use qs directly to generate complex query URLs instead of creating them manually.
You can use the following interactive query builder tool to generate query URLs automatically:
- Replace the values in the Endpoint and Endpoint Query Parameters fields with content that fits your needs.
- Click the Copy to clipboard button to copy the automatically generated Query String URL which is updated as you type.
:::info Parameters usage
Please refer to the REST API parameters table and read the corresponding parameters documentation pages to better understand parameters usage.
:::
<InteractiveQueryBuilder
endpoint="/api/books"
code={{ sort: ['title:asc'], filters: { title: { $eq: 'hello', }, }, populate: { author: { fields: ['firstName', 'lastName'] } }, fields: ['title'], pagination: { pageSize: 10, page: 1, }, status: 'published', locale: ['en'], } }
/>
:::caution Disclaimer
The qs library and the interactive query builder provided on this page:
- might not detect all syntax errors,
- are not aware of the parameters and values available in a Strapi project,
- and do not provide autocomplete features.
Currently, these tools are only provided to transform the JavaScript object in an inline query string URL. Using the generated query URL does not guarantee that proper results will get returned with your API.
:::