SERPHouseSERPHouse

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.

FormatEndpoint
JSON (default)https://api.serphouse.com/serp/live
Markdownhttps://api.serphouse.com/serp/live/md
HTMLhttps://api.serphouse.com/serp/live/html

Live SERP (POST)

Headers

NameTypeDescription
Authorization *StringBearer <YOUR_API_KEY>
Content-Type *Stringapplication/json

Request Body

NameTypeDescription
q *stringSearch phrase that you want to search
domain *stringChoose google, bing or yahoo domain.
You can get the list of available search engines by making a separate request to the Domains List
lang *stringYou 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 *stringDevice can be
desktop To extract desktop result
mobile To extract mobile result
serp_type *stringSerp type can be
web Get structured json result search engines web result
news Get news result from search engines
image Search image over search engines and get json result
shop Get a results of a Google Shopping search from search engines
loc *stringOptional field if you specify loc_id
When choose yahoo domain then field is optional
You must choose one of the fields: loc_id or loc
You 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 *integerOptional field if you specify loc
You must choose one of the fields: loc_id or loc
You can receive the list of available locations of search engines with their loc_id by making a separate request to the Locations List
verbatimintegerSet Google Verbatim search, Parameter value can be 0 or 1
gfilterintegerParameter 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.
pageintegerGive specific page to get the result of that page number. By default it will get you first page.
num_resultintegerDefine 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_rangeStringSometimes 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 OR

h Past hour
d Past 24 hours
w Past week
m Past month
y Past year
no_tracestring | integerEnterprise only. Enables NoTrace mode.
Live SERP (HTTP POST)Click to expand
Live SERP results from an HTTP POST request

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 &middot; 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&#39;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&#39;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&amp;t=7",            "description": "today we are going to talk more about AI let&#39;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&amp;t=29",            "description": "because what we call artificial intelligence isn&#39;t magic it&#39;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&#39;est-ce que vraiment l&#39;IA ? 🧠 L&#39;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&#39;intelligence artificielle ou IA est un domaine de l&#39;informatique c&#39;est un procédé logique et automatisé s&#39;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 &quot;Yeah okay a human could have done that.&quot; 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 &amp; 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&#39;est-ce que l&#39;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&amp;hl=en&amp;gl=FR&amp;q=What+is+artificial+intelligence+with+examples&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg1EAE"        },        {          "title": "Artificial intelligence app  ",          "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&amp;hl=en&amp;gl=FR&amp;q=Artificial+intelligence+app&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAhNEAE"        },        {          "title": "Artificial Intelligence course  ",          "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&amp;hl=en&amp;gl=FR&amp;q=Artificial+Intelligence+course&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAhGEAE"        },        {          "title": "Artificial Intelligence movie  ",          "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&amp;hl=en&amp;gl=FR&amp;q=Artificial+Intelligence+movie&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAhAEAE"        },        {          "title": "Artificial intelligence website  ",          "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&amp;hl=en&amp;gl=FR&amp;q=Artificial+intelligence+website&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg_EAE"        },        {          "title": "Best definition of artificial intelligence  ",          "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&amp;hl=en&amp;gl=FR&amp;q=Best+definition+of+artificial+intelligence&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg-EAE"        },        {          "title": "Artificial Intelligence PDF  ",          "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&amp;hl=en&amp;gl=FR&amp;q=Artificial+Intelligence+PDF&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg9EAE"        },        {          "title": "Artificial intelligence articles  ",          "link": "https://www.google.com/search?sca_esv=7083415dcaeee4fa&amp;hl=en&amp;gl=FR&amp;q=Artificial+intelligence+articles&amp;sa=X&amp;ved=2ahUKEwjh9PjbiISWAxXxGRAIHSArF7YQ1QJ6BAg2EAE"        }      ]    }  }}

Last updated on

How is this guide?

On this page