Live (HTTP POST)
Perform real-time SERP searches using HTTP POST requests with a JSON body.
Deprecated
This endpoint is deprecated and will be removed in a future release. Please migrate to the newer API.
Performing a realtime search using HTTP POST is very simple with the SERPHouse live endpoint.
Requires authentication → provide your API key as a Bearer token in the Authorization header.
POST 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 (POST)
Headers
| Name | Type | Description |
|---|---|---|
| Authorization * | String | Bearer <YOUR_API_KEY> |
| Content-Type * | String | application/json |
Request Body
| 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 resultshop Get a results of a Google Shopping search from search engines |
| 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 * | integer | 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 | integer | Set Google Verbatim search, Parameter value can be 0 or 1 |
| gfilter | integer | 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 | integer | Give specific page to get the result of that page number. By default it will get you first page. |
| num_result | integer | 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. |
| 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 |
| no_trace | string | integer | Enterprise only. Enables NoTrace mode. |
Live SERP (HTTP POST)Click to expand

Example Request
curl --location --request POST 'https://api.serphouse.com/serp/live' \--header 'Authorization: Bearer <YOUR_API_KEY>' \--header 'Content-Type: application/json' \--data-raw '{ "data": { "q": "Artificial Intelligence", "domain": "google.com", "lang": "en", "device": "desktop", "serp_type": "web", "loc": "Rennes,Brittany,France", "page": 1 }}'Example Response
{ "status": "success", "msg": "Completed", "results": { "search_metadata": { "id": 259415303, "status": "success", "created_at": "2026-08-03T08:44:34.000000Z", "processed_at": "2026-08-03 08:44:34" }, "search_parameters": { "domain": "google.com", "lang": "en", "country": "FR", "location": "Rennes,Brittany,France", "q": "Artificial Intelligence", "device": "desktop", "url": "https://www.google.com/search?q=Artificial+Intelligence&uule=w+CAIQICIWUmVubmVzLEJyaXR0YW55LEZyYW5jZQ==&hl=en&gl=FR&ie=UTF-8", "page": "1", "num": 10, "ie": "UTF-8" }, "results": { "search_information": [ { "total_results": "127", "time_taken_displayed": "0,35" } ], "ai_overview": { "title": "AI Overview", "contents": [ { "type": "heading", "snippet": "Artificial intelligence (AI) is the ability of computers and machines to do tasks that usually need human thinking, like learning, solving problems, and understanding language. Key examples include voice assistants, self-driving cars, and smart search tools. IBM +2" }, { "type": "heading", "snippet": "How AI Works" }, { "type": "heading", "snippet": "Common Uses" }, { "type": "paragraph_list", "list": [ { "title": "Algorithms", "snippet": "Use math steps to process data and find answers." }, { "title": "No Feelings", "snippet": "Machines do not have real awareness or emotions." }, { "title": "Pattern Finding", "snippet": "Systems study large sets of data to make smart choices. YouTube · History of Simple Things" } ] }, { "type": "paragraph_list", "list": [ { "title": "Chatbots", "snippet": "Answer user questions and chat via text." }, { "title": "Vision", "snippet": "" }, { "title": "Automation", "snippet": "Handle repetitive tasks in factories and offices fast. IBM +5" } ] }, { "type": "video", "link": "https://www.youtube.com/watch?v=y6rz71ZBcrU&t=29", "snippet": "For a quick and simple video explanation of how artificial intelligence works behind the scenes:", "source": "YouTube ", "channel": "History of Simple Things", "date": " 3 months ago" }, { "type": "heading", "snippet": "If you'd like, let me know:" }, { "type": "heading", "snippet": "I can share more targeted details!" }, { "type": "paragraph_list", "list": [ { "title": "specific part of AI", "snippet": "What specific part of AI you want to explore (like machine learning or generative AI)" }, { "title": "use AI", "snippet": "How you plan to use AI in your work or daily life" } ] } ], "references": [ { "title": "What Is Artificial Intelligence (AI)? - IBM", "link": "https://www.ibm.com/think/topics/artificial-intelligence", "description": "What is AI? Artificial intelligence (AI) is technology that enables computers and machines to simulate human learning, comprehensi...", "source": "IBM", "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcThRQC9RkQA2vWCsMLe6Yw2iOB4IhQCEd6TcoFh4GNRABXFDHNUmPJmtB7QrIvNW34oE9bCMQ" }, { "title": "Artificial intelligence - Wikipedia", "link": "https://en.wikipedia.org/wiki/Artificial_intelligence", "description": "Artificial intelligence (AI) is the capability of computational systems to perform tasks typically associated with human intellige...", "source": "Wikipedia", "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSawcjeUuwcrNcHsgqEtOIDfqQse0H8WUi2z0Dd0d-s7YP0bKFqUwAU3GlWQsAu8oo2S8p_Xg" }, { "title": "Artificial intelligence (AI) | Definition, Examples, Types, Applications ...", "link": "https://www.britannica.com/technology/artificial-intelligence", "description": "Encyclopaedia Britannica's editors oversee subject areas in which they have extensive knowledge, whether from years of experience ...", "source": "Encyclopedia Britannica", "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSUouniU2KhqUfbcTxeO3R9sbj0fCIXci5jha1VTD0BndzZDPFheods9ql8c83vJpchzWeFWA" }, { "title": "What Is AI? | Learn all about artificial intelligence", "link": "https://www.youtube.com/watch?v=JcXKbUIebrU&t=7", "description": "today we are going to talk more about AI let's start with what it is a simple way to describe AI is that it combines computer scie...", "source": "YouTube · Learn Bright", "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ8s8Kzix8NTtcH3qmNZbnzP4yj1gZB0TFxkEo6XmeraZ-KBPK1" }, { "title": "What Exactly Is Artificial Intelligence? (And How Does It Really Work?)", "link": "https://www.youtube.com/watch?v=y6rz71ZBcrU&t=29", "description": "because what we call artificial intelligence isn't magic it's a system built piece by piece shaped by decades of curiosity trial a...", "source": "YouTube · History of Simple Things", "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSF_xD3rhAl4c52ZdNJ0SyydFxexESYA_xjQ52pbb5ww3Tw3UUz" }, { "title": "🤖 Qu'est-ce que vraiment l'IA ? 🧠 L'intelligence artificielle façonne notre ...", "link": "https://www.facebook.com/cea.pageofficielle/videos/-quest-ce-que-vraiment-lia-lintelligence-artificielle-fa%C3%A7onne-notre-quotidien-as/1017691343569928/", "description": "l'intelligence artificielle ou IA est un domaine de l'informatique c'est un procédé logique et automatisé s'appuyant sur des. algo...", "source": "Facebook · CEA", "image": null }, { "title": "AI Won’t Destroy Work, It Will Just Change It – OpEd", "link": "https://www.eurasiareview.com/03082026-ai-wont-destroy-work-it-will-just-change-it-oped/", "description": "Key Takeaways: AI will disrupt white-collar work by automating routine cognitive tasks, but—like past technologies such as agricul...", "source": "Eurasia Review", "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRsnNgoUD6tHR8YLkbKWp8nV3hofdVsN_Xt7QHAQsaEiHO0POKTFMqhJLddyBlh0LhqvW7-xw" }, { "title": "What is Artificial Intelligence in Simple Words?", "link": "https://www.facebook.com/melrobbins/videos/what-is-artificial-intelligence-in-simple-words/1568825004145468/", "description": "upon seeing the the final writing the final tweet the final image the final video goes "Yeah okay a human could have done that." G...", "source": "www.facebook.com", "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQazgJT4_qnR-ESwdoDFVdbfAm0UC8uOnfgk9IKNqqUl83UW1xByJ6_QxI53w" } ] }, "inline_videos": [ { "title": "What Exactly Is Artificial Intelligence? (And How Does It Really ... ", "source": "YouTube", "channel": "History of Simple Things", "date": "7 Apr 2026", "url": "https://www.youtube.com/watch?v=y6rz71ZBcrU" }, { "title": "What is Artificial Intelligence (AI)? - Introductory Training Course ", "source": "YouTube", "channel": "CNRS - Formation FIDLE", "date": "25 Nov 2025", "url": "https://www.youtube.com/watch?v=Jkzco779xpI" }, { "title": "The Incredible Discoveries That AI Could Make Possible ", "source": "YouTube", "channel": "Balade Mentale", "date": "1 month ago", "url": "https://www.youtube.com/watch?v=q4YT5QPFrgQ" } ], "organic": [ { "position": 1, "site_title": "IBM", "title": "What Is Artificial Intelligence (AI)?", "link": "https://www.ibm.com/think/topics/artificial-intelligence", "displayed_link": "https://www.ibm.com › think › topics › artificial-intellig... ", "cached_page": null, "snippet": "Artificial intelligence (AI) is technology that enables computers and machines to simulate human learning, comprehension, problem solving, ...", "snippet_extension": [ "9 Aug 2024" ] }, { "position": 2, "site_title": "Wikipedia", "title": "Artificial intelligence", "link": "https://en.wikipedia.org/wiki/Artificial_intelligence", "displayed_link": "https://en.wikipedia.org › wiki › Artificial_intelligence ", "cached_page": null, "snippet": "Artificial intelligence (AI) is the capability of computational systems to perform tasks typically associated with human intelligence" }, { "position": 3, "site_title": "Hewlett Packard Enterprise", "title": "What is Artificial Intelligence (AI)? | Glossary", "link": "https://www.hpe.com/fr/fr/what-is/artificial-intelligence.html", "displayed_link": "https://www.hpe.com › what-is › artificial-intelligence ", "cached_page": null, "snippet": "Artificial intelligence (AI) broadly refers to any human-like behavior displayed by a machine or system. In AI's most basic form, computers are programmed ..." }, { "position": 4, "site_title": "Google Cloud", "title": "What is Artificial Intelligence (AI)?", "link": "https://cloud.google.com/learn/what-is-artificial-intelligence", "displayed_link": "https://cloud.google.com › learn › what-is-artificial-intell... ", "cached_page": null, "snippet": "AI is a field of computer science focused on creating smart machines that can perform tasks that typically require human intelligence, like learning, reasoning ..." }, { "position": 5, "site_title": "UNESCO", "title": "Artificial Intelligence and emerging technologies", "link": "https://www.unesco.org/en/artificial-intelligence", "displayed_link": "https://www.unesco.org › artificial-intelligence ", "cached_page": null, "snippet": "We leverage AI to advance innovative, science-based solutions for sustainable development – from managing water and biodiversity to reducing disaster risks and ..." }, { "position": 6, "site_title": "Encyclopedia Britannica", "title": "Artificial intelligence (AI) | Definition, Examples, Types ...", "link": "https://www.britannica.com/technology/artificial-intelligence", "displayed_link": "https://www.britannica.com › Technology › Computers ", "cached_page": null, "snippet": "Artificial intelligence (AI), the ability of a digital computer or computer-controlled robot to perform tasks commonly associated with intelligent beings.", "snippet_extension": [ "3 days ago" ] }, { "position": 7, "site_title": "SAS: Data and AI Solutions", "title": "Artificial Intelligence – What is AI & Why It Matters", "link": "https://www.sas.com/en_nz/insights/analytics/what-is-artificial-intelligence.html", "displayed_link": "https://www.sas.com › SAS Insights › Analytics Insights ", "cached_page": null, "snippet": "Artificial intelligence (AI) makes it possible for machines to learn from experience, adjust to new inputs and perform human-like tasks." }, { "position": 8, "site_title": "NetApp", "title": "Qu'est-ce que l'intelligence artificielle (IA) et pourquoi est- ...", "link": "https://www.netapp.com/fr/artificial-intelligence/what-is-artificial-intelligence/", "displayed_link": "https://www.netapp.com › what-is-... ", "cached_page": null, "snippet": "L'intelligence artificielle (IA) est un processus d'imitation de l'intelligence humaine qui repose sur la création et l'application d'algorithmes exécutés dans ..." } ], "people_also_ask": [ { "question": "What are the 4 types of AI? ", "answer": "" }, { "question": "What 5 jobs will AI not replace? ", "answer": "" }, { "question": "Who is the father of AI? ", "answer": "" }, { "question": "Which country is no. 1 in AI? ", "answer": "" } ], "related_search": [ { "title": "What is artificial intelligence with examples ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=What+is+artificial+intelligence+with+examples&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg1EAE" }, { "title": "Artificial intelligence app ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=Artificial+intelligence+app&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAhNEAE" }, { "title": "Artificial Intelligence course ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=Artificial+Intelligence+course&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAhGEAE" }, { "title": "Artificial Intelligence movie ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=Artificial+Intelligence+movie&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAhAEAE" }, { "title": "Artificial intelligence website ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=Artificial+intelligence+website&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg_EAE" }, { "title": "Best definition of artificial intelligence ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=Best+definition+of+artificial+intelligence&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg-EAE" }, { "title": "Artificial Intelligence PDF ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=Artificial+Intelligence+PDF&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg9EAE" }, { "title": "Artificial intelligence articles ", "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&hl=en&gl=FR&q=Artificial+intelligence+articles&sa=X&ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg2EAE" } ] } }}Related Links
Last updated on
How is this guide?