use ApiPlatform\Metadata\QueryParameter; class Foo { #[QueryParameter(key: 'q', property: 'hydra:freetextQuery', required: true)] public $q; }