Live (HTTP GET)
Perform real-time SERP searches using HTTP GET requests with query parameters.
Deprecated
This endpoint is deprecated and will be removed in a future release. Please migrate to the newer API.
Performing a realtime search is as simple as making a GET HTTP request to the SERPHouse live endpoint. The only required parameters are your API key and q (your search query).
Requires authentication → provide your API key as a Bearer token in the Authorization header.
GET https://api.serphouse.com/serp/live
Response types
These are the response types we support. Append a suffix to the endpoint to choose the response format.
| Format | Endpoint |
|---|---|
| JSON (default) | https://api.serphouse.com/serp/live |
| Markdown | https://api.serphouse.com/serp/live/md |
| HTML | https://api.serphouse.com/serp/live/html |
Live SERP (GET)
Query Parameters
| Name | Type | Description |
|---|---|---|
| q * | String | Search phrase that you want to search |
| domain | String | Choose google, bing or yahoo domain.You can get the list of available search engines by making a separate request to the Domains List |
| lang | String | You can set language for e.g. en for english fr for french.Get the list of available languages by making a separate request to the Languages List |
| device | String | Device can bedesktop To extract desktop resultmobile To extract mobile result |
| serp_type | String | Serp type can beweb get structured json result search engines web resultnews Get news result from search enginesimage Search image over search engines and get json result |
| loc | String | Optional field if you specify loc_idWhen choose yahoo domain then field is optional You must choose one of the fields: loc_id or locYou can receive the list of available locations of search engines with their loc_id by making a separate request to the Locations List |
| loc_id | String | Optional field if you specify locYou must choose one of the fields: loc_id or locYou can receive the list of available locations of search engines with their loc_id by making a separate request to the Locations List |
| verbatim | String | Set Google Verbatim search, Parameter value can be 0 or 1 |
| gfilter | String | Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to 1 (default) to enable these filters, or 0 to disable these filters. |
| page | String | Give specific page to get the result of that page number. By default it will get you first page. |
| num_result | String | Define the number of results you want to get per page. By default, you will get up to 10 results. Maximum 10 results are available. |
| api_token * | String | Your API key Optional if you specify an Authorization header in request |
| date_range | String | Sometimes you may want to only find information published during a specific time frame. To limit Google results by date Parameter values can be comma separated date range YYYY-MM-DD,YYYY-MM-DD ORh Past hourd Past 24 hoursw Past weekm Past monthy Past year |
Headers
| Name | Type | Description |
|---|---|---|
| Authorization * | String | Bearer <YOUR_API_KEY> |
Live SERP (HTTP GET)Click to expand
Example Request
curl --location --request GET 'https://api.serphouse.com/serp/live?q=apple&domain=google.com&lang=en&device=desktop&serp_type=web&loc=Alba,Texas,United States' \--header 'Authorization: Bearer <YOUR_API_KEY>'Example Response
{ "status": "success", "msg": "Completed", "results": { "search_metadata": { "id": 259416301, "status": "success", "created_at": "2026-08-03T08:51:00.000000Z", "processed_at": "2026-08-03 08:51:00" }, "search_parameters": { "domain": "google.com", "lang": "en", "country": "US", "location": "Alba,Texas,United States", "q": "apple", "device": "desktop", "url": "https://www.google.com/search?q=apple&uule=w+CAIQICIYQWxiYSxUZXhhcyxVbml0ZWQgU3RhdGVz&hl=en&gl=US&ie=UTF-8&tbs=li:1", "page": "1", "num": 10, "ie": "UTF-8", "tbs": "li:1" }, "results": { "search_information": [ { "total_results": "3,810,000,000", "time_taken_displayed": "0.42" } ], "organic": [ { "position": 1, "site_title": "Apple", "title": "Apple", "link": "https://www.apple.com/", "displayed_link": "https://www.apple.com", "cached_page": null, "snippet": "Discover the innovative world of Apple and shop everything iPhone, iPad, Apple Watch, Mac, and Apple TV, plus explore accessories, entertainment, ..." }, { "position": 2, "site_title": "iCloud", "title": "iCloud", "link": "https://www.icloud.com/", "displayed_link": "https://www.icloud.com", "cached_page": null, "snippet": "Log in to iCloud to access your photos, mail, notes, documents and more. Easily access apps and data from your iPhone on the web" }, { "position": 3, "site_title": "Wikipedia", "title": "Apple Inc.", "link": "https://en.wikipedia.org/wiki/Apple_Inc.", "displayed_link": "https://en.wikipedia.org › wiki › Apple_Inc ", "cached_page": null, "snippet": "Apple Inc. is an American multinational technology company headquartered in Cupertino, California, in Silicon Valley, and known for consumer electronics, ..." }, { "position": 4, "site_title": "YouTube · Apple", "title": "Apple", "link": "https://www.youtube.com/apple", "displayed_link": "20.7M+ followers", "cached_page": null, "snippet": "Welcome to the official Apple YouTube channel. Here you'll find news about product launches, tutorials, and other great content. latest from iPad, iPad Pro, ..." }, { "position": 5, "site_title": "LinkedIn · Apple", "title": "Apple", "link": "https://www.linkedin.com/company/apple", "displayed_link": "18.4M+ followers", "cached_page": null, "snippet": "Apple Industry Computers and Electronics Manufacturing Company size. Innovative Product Development, World-Class Operations, Retail, and Telephone Support" }, { "position": 6, "site_title": "Reddit · r/apple", "title": "r/Apple: Unofficial Apple Community", "link": "https://www.reddit.com/r/apple/", "displayed_link": "6.4M+ followers", "cached_page": null, "snippet": "An unofficial community about Apple and all of its devices and software. Everything is playable in the app via Apple Music Apple Watch, CarPlay, Siri intents, ..." }, { "position": 7, "site_title": "Apple", "title": "ID in Wallet", "link": "https://learn.wallet.apple/id", "displayed_link": "https://learn.wallet.apple › ... ", "cached_page": null, "snippet": "Simply add your eligible ID to the Wallet app and use it to show proof of age or identity at select businesses, venues, online, and in-app." } ], "people_also_ask": [ { "question": "What if I invested $10,000 in Apple 30 years ago? ", "answer": "" }, { "question": "Which iPhones are outdated in 2026? ", "answer": "" }, { "question": "Should you shut down a Mac every night? ", "answer": "" }, { "question": "What is the secret button on the iPhone? ", "answer": "" } ], "related_search": [ { "title": "Apple login ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+login&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgpEAE" }, { "title": "Apple ID ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+ID&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgvEAE" }, { "title": "Apple Store near me ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+Store+near+me&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgzEAE" }, { "title": "Apple fruit ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+fruit&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgoEAE" }, { "title": "Apple Store login ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+Store+login&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgtEAE" }, { "title": "Apple Account ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+Account&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgwEAE" }, { "title": "Apple app ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+app&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgnEAE" }, { "title": "Apple logo ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=US&tbs=li:1&q=Apple+logo&sa=X&ved=2ahUKEwiS2-eXioSWAxVQjOEIHUeiEpYQ1QJ6BAgqEAE" } ] } }}Related Links
Last updated on
How is this guide?