--- title: Build a Laravel Scout Search Endpoint With the HTTP... description: The HTTP QUERY method (RFC 10008) is a new HTTP verb designed for safe, cacheable queries that carry parameters in the request body. Laravel 13.19 added... canonical: https://daily.dev/posts/build-a-laravel-scout-search-endpoint-with-the-http-query-method-hgbteipqq twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Build a Laravel Scout Search Endpoint With the HTTP QUERY Method | daily.dev og:description: The HTTP QUERY method (RFC 10008) is a new HTTP verb designed for safe, cacheable queries that carry parameters in the request body. Laravel 13.19 added... og:url: https://daily.dev/posts/build-a-laravel-scout-search-endpoint-with-the-http-query-method-hgbteipqq og:image: https://api.daily.dev/og/posts/hgbTEiPqQ.png og:image:alt: Build a Laravel Scout Search Endpoint With the HTTP QUERY Method og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Build a Laravel Scout Search Endpoint With the HTTP QUERY Method **[Laravel News](https://daily.dev/sources/ln)** · 7 min read · 2 upvotes · 0 comments ## Summary The HTTP QUERY method (RFC 10008) is a new HTTP verb designed for safe, cacheable queries that carry parameters in the request body. Laravel 13.19 added Http::query() and queryJson() testing helpers, with Route::query() coming in Laravel 14. This tutorial shows how to build a search endpoint using Route::match(['QUERY'], ...) with Laravel Scout's database driver today. It covers setting up Scout, defining the route, writing feature tests with queryJson(), and handling gotchas like PHP's built-in server returning 501, CSRF middleware treating QUERY like POST in web routes (with a backport fix), and production considerations around CDNs, browser support, and OpenAPI tooling. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### How do I define a route that responds to the HTTP QUERY method in Laravel 13? Use Route::match(['QUERY'], '/path', $handler) since Laravel 13's router accepts custom verbs, including QUERY, even though a dedicated Route::query() helper isn't available until Laravel 14. Request validation and $request->input() read from the JSON body the same way they do for POST requests, requiring no extra work. _Developers wiring up new HTTP verbs in Laravel can track framework routing changes like this on daily.dev._ ### Why does php artisan serve return a 501 error for HTTP QUERY requests in Laravel? PHP's built-in development server hard-codes the request methods it accepts and rejects QUERY before it ever reaches the Laravel application, returning a 501 Not Implemented response. Nginx-based environments such as Laravel Herd and Valet pass the QUERY method through correctly, so switching local dev environments avoids the issue. _daily.dev helps Laravel developers spot local-environment gotchas like this before they cost debugging time._ ### Does Laravel's CSRF protection block HTTP QUERY requests on web routes? Yes, in Laravel 13 the PreventRequestForgery middleware only treats GET, HEAD, and OPTIONS as read verbs, so a QUERY route in routes/web.php triggers a 419 CSRF error just like POST would. Laravel's next major release exempts QUERY as a safe method per RFC 10008, but until then you must extend the middleware to add QUERY to the read-verb list or exclude the route from the middleware entirely. _daily.dev keeps API developers current on framework security middleware changes like this CSRF exemption._ ## Similar posts on daily.dev - [HTTP Query Method Support in Laravel 13.19](https://daily.dev/posts/http-query-method-support-in-laravel-13-19-lqz2nkd8s) · Laravel News · 28 upvotes · 4 comments - [Why HTTP needed a new method after 30 years - meet QUERY](https://daily.dev/posts/why-http-needed-a-new-method-after-30-years---meet-query-a5uhffgpn) · Medium · 12 upvotes · 1 comments - [HTTP gets a QUERY method so complex searches can stop pretending to be POST](https://daily.dev/posts/http-gets-a-query-method-so-complex-searches-can-stop-pretending-to-be-post-mk7367aia) · DEVCLASS · 294 upvotes · 16 comments - [RFC 10008: The HTTP QUERY Method](https://daily.dev/posts/rfc-10008-the-http-query-method-4azpxbmjt) · Blain Smith · 18 upvotes · 0 comments --- Tags: [#php](https://daily.dev/tags/php), [#laravel](https://daily.dev/tags/laravel), [#rest-api](https://daily.dev/tags/rest-api) [View this post on daily.dev](https://daily.dev/posts/build-a-laravel-scout-search-endpoint-with-the-http-query-method-hgbteipqq) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Build a Laravel Scout Search Endpoint With the HTTP QUERY Method","url":"https://daily.dev/posts/build-a-laravel-scout-search-endpoint-with-the-http-query-method-hgbteipqq","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/build-a-laravel-scout-search-endpoint-with-the-http-query-method-hgbteipqq"},"datePublished":"2026-07-16T13:30:48.920Z","dateModified":"2026-09-13T20:53:37.716Z","description":"The HTTP QUERY method (RFC 10008) is a new HTTP verb designed for safe, cacheable queries that carry parameters in the request body. Laravel 13.19 added...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/3532691e9eeed6fb5f602226b0466d4d?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/3532691e9eeed6fb5f602226b0466d4d?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Laravel News","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Laravel News","logo":"https://media.daily.dev/image/upload/t_logo,f_auto/v1/logos/ln","url":"https://daily.dev/sources/ln"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/build-a-laravel-scout-search-endpoint-with-the-http-query-method-hgbteipqq","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":2},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"php,laravel,rest-api","timeRequired":"PT7M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Laravel News","item":"https://daily.dev/sources/ln"},{"@type":"ListItem","position":3,"name":"Build a Laravel Scout Search Endpoint With the HTTP QUERY Method"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/build-a-laravel-scout-search-endpoint-with-the-http-query-method-hgbteipqq#faq","mainEntity":[{"@type":"Question","name":"How do I define a route that responds to the HTTP QUERY method in Laravel 13?","acceptedAnswer":{"@type":"Answer","text":"Use Route::match(['QUERY'], '/path', $handler) since Laravel 13's router accepts custom verbs, including QUERY, even though a dedicated Route::query() helper isn't available until Laravel 14. Request validation and $request->input() read from the JSON body the same way they do for POST requests, requiring no extra work. Developers wiring up new HTTP verbs in Laravel can track framework routing changes like this on daily.dev."}},{"@type":"Question","name":"Why does php artisan serve return a 501 error for HTTP QUERY requests in Laravel?","acceptedAnswer":{"@type":"Answer","text":"PHP's built-in development server hard-codes the request methods it accepts and rejects QUERY before it ever reaches the Laravel application, returning a 501 Not Implemented response. Nginx-based environments such as Laravel Herd and Valet pass the QUERY method through correctly, so switching local dev environments avoids the issue. daily.dev helps Laravel developers spot local-environment gotchas like this before they cost debugging time."}},{"@type":"Question","name":"Does Laravel's CSRF protection block HTTP QUERY requests on web routes?","acceptedAnswer":{"@type":"Answer","text":"Yes, in Laravel 13 the PreventRequestForgery middleware only treats GET, HEAD, and OPTIONS as read verbs, so a QUERY route in routes/web.php triggers a 419 CSRF error just like POST would. Laravel's next major release exempts QUERY as a safe method per RFC 10008, but until then you must extend the middleware to add QUERY to the read-verb list or exclude the route from the middleware entirely. daily.dev keeps API developers current on framework security middleware changes like this CSRF exemption."}}]} ```