rodrigogalura / tuner
A Laravel package to fine-tune your APIs — let clients shape the data with powerful query modifiers.
Fund package maintenance!
Ko Fi
Requires
- php: 8.3.*
Requires (Dev)
- laravel/pint: ^1.21
- mockery/mockery: ^1.6
- orchestra/testbench: ^10.1
- pestphp/pest: ^3.7
- pestphp/pest-plugin-laravel: ^3.1
- rector/rector: dev-main
README

A Laravel package to fine-tune your APIs — let clients shape the data with powerful query modifiers.
Explore the docs »
Report Bug
·
Request Feature
Table of Contents
About The Project
This package was born out of real-world needs in my own projects. I created it to cut down on boilerplate and give frontend consumers more control and flexibility. I’m simply sharing the tools that helped me build faster — and I hope they’ll do the same for you.
Main Features
Projection
Select only the columns you need instead of retrieving every column.
Available modifiers:
columns
– Include only the specified columns.columns!
– Exclude the specified columns (opposite effect).
Sort
Order results in ascending or descending order.
- Use the
sort
modifier to define one or more sort columns.
Search
Filter results based on a search keyword with optional wildcards.
- Use the
search
modifier.
Available wildcards:
*term
– Match at the beginning.term*
– Match at the end.*term*
– Match anywhere (flexible).
Filter
Go beyond simple search with advanced filtering.
Available modifiers:
filter
in
between
filter
Supports relational and arithmetic operators:
=
: Equal>
: Greater than<
: Less than>=
: Greater than or equal<=
: Less than or equal<>
: Not equal
in
Filter results that match any value in a given list.
between
Filter results within a range of values (numbers, text, or dates).
Logical operators are supported for advanced filtering
:
AND
OR
AND!
OR!
Limitation
Restrict the number of results returned by specifying a maximum limit.
Pagination
Leverage Laravel’s built-in pagination system for efficient, page-based responses.
Roadmap
You can access the Tuner roadmap here.
License
The Tuner is open-sourced software licensed under the MIT license.
Contact
If you discover any security vulnerabilities, please contact me. This allows me to address the issue promptly and responsibly.
Rodrigo Galura - rodrigogalura3rd@gmail.com
☕️ Buy Me a Coffee
If this project helped you or saved you time, consider buying me a coffee. Your support means a lot and helps keep this project active and maintained!