# Get SERP Result

As a response of the API server, you will receive an json array containing a result of your serp query.

{% hint style="danger" %}
Requires authentication
{% endhint %}

<mark style="color:blue;">`GET`</mark> `https://api.serphouse.com/serp/get`

#### Path Parameters

| Name         | Type   | Description                          |
| ------------ | ------ | ------------------------------------ |
| responseType | String | responseType can be 'html' or 'json' |

#### Query Parameters

| Name                                 | Type   | Description                         |
| ------------------------------------ | ------ | ----------------------------------- |
| id<mark style="color:red;">\*</mark> | String | unique identifier of your serp task |

#### Headers

| Name                                            | Type   | Description              |
| ----------------------------------------------- | ------ | ------------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer \<YOUR\_API\_KEY> |

{% tabs %}
{% tab title="200: OK Successful operation" %}

```json
{
    "status": "success",
    "msg": "",
    "results": {
        "search_metadata": {
            "id": 77308220,
            "status": "success",
            "created_at": "2023-05-31T07:14:15.000000Z",
            "processed_at": "2023-05-31 07:15:10"
        },
        "search_parameters": {
            "domain": "google.com",
            "lang": "en",
            "country": "US",
            "location": "Alba,Texas,United States",
            "q": "Tea",
            "device": "desktop",
            "url": "https://www.google.com/search?q=Tea&uule=w+CAIQICIYQWxiYSxUZXhhcyxVbml0ZWQgU3RhdGVz&hl=en&gl=US&num=100&ie=UTF-8",
            "page": "1",
            "num": 100,
            "ie": "UTF-8"
        },
        "results": {
            "search_information": [
                {
                    "total_results": "2,920,000,000",
                    "time_taken_displayed": "0.79"
                }
            ],
            "local_pack": [
                {
                    "position": 1,
                    "title": "Nutrition on the edge",
                    "rating": "5.0",
                    "reviews_count": "(2)",
                    "type": "Coffee shop",
                    "address": "151 E Quitman St",
                    "open_state": " \"Great place to get a good tea, And shake .\"  "
                },
                {
                    "position": 2,
                    "title": "Countrygirls Coffee &amp; more",
                    "rating": "5.0",
                    "reviews_count": "(2)",
                    "type": "Coffee shop",
                    "address": "151 E Quitman St",
                    "open_state": "Closed  ⋅ Opens 6 AM "
                },
                {
                    "position": 3,
                    "title": "Harlequin Tea",
                    "rating": "",
                    "reviews_count": "",
                    "type": "",
                    "address": "No reviews  &middot; Tea store",
                    "open_state": "Wills Point, TX"
                }
            ],
            "organic": [
                {
                    "position": 1,
                    "site_title": "Texas.gov",
                    "title": "Texas Education Agency - Texas.gov",
                    "link": "https://tea.texas.gov/",
                    "displayed_link": "https://tea.texas.gov",
                    "cached_page": "",
                    "snippet": "The Latest TEA News. The latest news from the Texas Education Agency is available through news releases, online correspondence, mailing lists, ...",
                    "sitelinks": {
                        "expanded": [
                            {
                                "link": "https://tea.texas.gov/texas-educators/certification",
                                "title": "Certification"
                            },
                            {
                                "link": "https://tea.texas.gov/texas-educators/certification/certificate-lookup",
                                "title": "Certificate Lookup"
                            },
                            {
                                "link": "https://tea.texas.gov/about-tea/contact-us",
                                "title": "Contact Us"
                            },
                            {
                                "link": "https://tea.texas.gov/about-tea",
                                "title": "About TEA"
                            },
                            {
                                "link": "https://www.google.com/search?q=Tea+site:texas.gov&num=100&hl=en&gl=US&sa=X&ved=2ahUKEwistNOigZ__AhWVtYQIHU_PDy8QrAN6BAgYEAE",
                                "title": "More results from texas.gov&nbsp;&raquo;"
                            }
                        ]
                    }
                },
                {
                    "position": 2,
                    "site_title": "Texas Education Agency (.gov)",
                    "title": "Texas Education Agency",
                    "link": "https://tealprod.tea.state.tx.us/",
                    "displayed_link": "https://tealprod.tea.state.tx.us",
                    "cached_page": "",
                    "snippet": "For help with account access, please enter a request at the online TEA Help Desk. Copyright © 2023 The Texas Education Agency, 1701 North Congress Ave, Austin, ...",
                    "sitelinks": {
                        "inline": [
                            {
                                "link": "https://tealprod.tea.state.tx.us/TSP/TEASecurePortal/jsp/forgot_password.jsp",
                                "title": "Forgot your password?"
                            },
                            {
                                "link": "https://tealprod.tea.state.tx.us/WebHelp/IAM.htm",
                                "title": "TEA Login Application Help"
                            }
                        ]
                    }
                },
                {
                    "position": 3,
                    "site_title": "Wikipedia",
                    "title": "Tea - Wikipedia",
                    "link": "https://en.wikipedia.org/wiki/Tea",
                    "displayed_link": "https://en.wikipedia.org › wiki › Tea ",
                    "cached_page": "",
                    "snippet": "Tea is an aromatic beverage prepared by pouring hot or boiling water over cured or fresh leaves of Camellia sinensis, an evergreen shrub native to East Asia ..."
                },
                {
                    "position": 4,
                    "site_title": "Tea Collection",
                    "title": "Tea Collection | Children&#39;s Clothes for Kids, Baby &amp; Newborn",
                    "link": "https://www.teacollection.com/",
                    "displayed_link": "https://www.teacollection.com",
                    "cached_page": "",
                    "snippet": "At Tea Collection, we travel the world to bring you globally inspired, well-made kids clothes for all of life's adventures. Shop Tea Collection children's ...",
                    "sitelinks": {
                        "inline": [
                            {
                                "link": "https://www.teacollection.com/clothing-sale",
                                "title": "Sale"
                            },
                            {
                                "link": "https://www.teacollection.com/girls-dresses",
                                "title": "Dresses"
                            },
                            {
                                "link": "https://www.teacollection.com/girls-clothing",
                                "title": "All Girls Clothes at Tea..."
                            },
                            {
                                "link": "https://www.teacollection.com/shop-locations",
                                "title": "Find a Store"
                            }
                        ]
                    }
                },
                {
                    "position": 5,
                    "site_title": "Tea Forte",
                    "title": "Tea Forte: Tea Forté | The Exceptional Tea Experience",
                    "link": "https://teaforte.com/",
                    "displayed_link": "https://teaforte.com",
                    "cached_page": "",
                    "snippet": "Tea Forté's gourmet whole leaf teas in our leaf topped pyramid silken infuser define the contemporary tea experience."
                },
                {
                    "position": 6,
                    "site_title": "TEAinTEXAS",
                    "title": "TEAinTEXAS | Hand-crafted Tea",
                    "link": "https://teaintexas.com/",
                    "displayed_link": "https://teaintexas.com",
                    "cached_page": "",
                    "snippet": "Taking our sweet time, TEAinTEXAS blends natural teas with old-fashioned flare, putting the TEA in TEXAS since 2010. We responsibly source herbs and fruits from ..."
                },
                {
                    "position": 7,
                    "site_title": "Merriam-Webster",
                    "title": "Tea Definition &amp; Meaning",
                    "link": "https://www.merriam-webster.com/dictionary/tea",
                    "displayed_link": "https://www.merriam-webster.com › dictionary › tea ",
                    "cached_page": "",
                    "snippet": "The meaning of TEA is a widely cultivated shrub (Camellia sinensis of the family Theaceae, the tea family) native to China, northern India, and southeastern ..."
                },
                {
                    "position": 8,
                    "site_title": "Art of Tea",
                    "title": "Art of Tea: Organic Loose Leaf Teas, Tea Bags &amp; Tea Gift",
                    "link": "https://www.artoftea.com/",
                    "displayed_link": "https://www.artoftea.com",
                    "cached_page": "",
                    "snippet": "Explore Art of Tea, an organic online tea shop with a wide variety of loose leaf, packaged teas, teaware, tea gifts &amp; more. Shop custom-crafted teas today!"
                },
                {
                    "position": 9,
                    "site_title": "tealearn.com",
                    "title": "TEA Learn",
                    "link": "https://register.tealearn.com/",
                    "displayed_link": "https://register.tealearn.com",
                    "cached_page": "",
                    "snippet": "20 listings  —  This course is the first of five modules in which you will explore a teacher's journey through several days of professional learning and ...",
                    "snippet_extension": [
                        "20 listings"
                    ]
                },
                {
                    "position": 10,
                    "site_title": "Cambridge University Press &amp; Assessment",
                    "title": "TEA | English meaning - Cambridge Dictionary",
                    "link": "https://dictionary.cambridge.org/dictionary/english/tea",
                    "displayed_link": "https://dictionary.cambridge.org › dictionary › tea ",
                    "cached_page": "",
                    "snippet": "tea definition: 1. (a drink made by pouring hot water onto) dried and cut leaves and sometimes flowers, especially…. Learn more."
                }
            ],
            "people_also_ask": [
                {
                    "question": "What's TEA in Texas? ",
                    "answer": null
                },
                {
                    "question": "What is the TEA in education? ",
                    "answer": null
                },
                {
                    "question": "Can you be a teacher without a degree in Texas? ",
                    "answer": null
                },
                {
                    "question": "What are the 8 categories of essential knowledge and skills under TEKS? ",
                    "answer": null
                }
            ],
            "knowledge_card": {
                "image": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
                "title": "Tea ",
                "subtitle": "Beverage ",
                "description": "DescriptionTea is an aromatic beverage prepared by pouring hot or boiling water over cured or fresh leaves of Camellia sinensis, an evergreen shrub native to East Asia which probably originated in the borderlands of southwestern China and northern Myanmar. Tea is also rarely made from the leaves of Camellia taliensis.   Wikipedia ",
                "hibiscus": "Hibiscus sabdariffa",
                "lab/title/Caffeine Amount": "Caffeine Amount does tea have caffeine",
                "lab/title/Benefits": "Benefits benefits of tea",
                "lab/title/Types": "Types types of tea",
                "lab/title/Energy Amount": "Energy Amount how many calories in tea",
                "people_also_search": [
                    {
                        "position": 1,
                        "image": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
                        "title": "BLUE Ribbon Twinings..."
                    },
                    {
                        "position": 2,
                        "image": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
                        "title": "Harney Sons Tea"
                    },
                    {
                        "position": 3,
                        "image": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
                        "title": "Taylors of Harrogate Assorted..."
                    },
                    {
                        "position": 4,
                        "image": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
                        "title": "Teas' Tea Unsweetened Green Tea"
                    }
                ]
            },
            "related_search": [
                {
                    "title": "texas tea brand",
                    "link": "https://www.google.com/search?num=100&amp;hl=en&amp;gl=US&amp;q=Texas+Tea+brand&amp;sa=X&amp;ved=2ahUKEwistNOigZ__AhWVtYQIHU_PDy8Q1QJ6BAg_EAE"
                },
                {
                    "title": "tea leaves",
                    "link": "https://www.google.com/search?num=100&amp;hl=en&amp;gl=US&amp;q=Tea+leaves&amp;sa=X&amp;ved=2ahUKEwistNOigZ__AhWVtYQIHU_PDy8Q1QJ6BAg9EAE"
                },
                {
                    "title": "who invented tea in india",
                    "link": "https://www.google.com/search?num=100&amp;hl=en&amp;gl=US&amp;q=Who+invented+tea+in+India&amp;sa=X&amp;ved=2ahUKEwistNOigZ__AhWVtYQIHU_PDy8Q1QJ6BAg7EAE"
                }
            ]
        }
    }
}
```

{% endtab %}

{% tab title="404: Not Found Failed operation" %}

```json
{
    "status": "error",
    "msg": "Keyword is not processed yet.",
    "error": ""
}
```

{% endtab %}

{% tab title="404: Not Found Failed operation" %}

```json
{
    "status": "error",
    "msg": "Response type can be 'html' or 'json'",
    "error": ""
}
```

{% endtab %}

{% tab title="400: Bad Request Failed operation" %}

```json
{
    "status": "error",
    "msg": "Invalid ID provided.",
    "error": ""
}
```

{% endtab %}

{% tab title="401: Unauthorized Unauthenticated" %}

```json
{
    "status": "error",
    "msg": "Unauthenticated"
}
```

{% endtab %}

{% tab title="404: Not Found Failed operation" %}

```json
{
    "status": "error",
    "msg": "not found",
    "error": ""
}
```

{% endtab %}
{% endtabs %}

## Example request:

{% tabs %}
{% tab title="BASH" %}

```bash
curl --location --request GET 'https://api.serphouse.com/serp/get?id=77224195' \
--header 'Authorization: Bearer <YOUR_API_KEY>'
```

{% endtab %}

{% tab title="RUBY" %}

```ruby
require "uri"
require "net/http"

url = URI("https://api.serphouse.com/serp/get?id=77224195")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer <YOUR_API_KEY>"

response = https.request(request)
puts response.read_body

```

{% endtab %}

{% tab title="PYTHON" %}

```python
import requests

url = "https://api.serphouse.com/serp/get?id=77224195"

payload={}
headers = {
  'Authorization': 'Bearer <YOUR_API_KEY>'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}

{% tab title="NODE.JS" %}

```javascript
var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api.serphouse.com/serp/get?id=77224195',
  headers: { 
    'Authorization': 'Bearer <YOUR_API_KEY>'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$serphouse = new SERPHouse\SERPHouseClient('YOUR_API_KEY');
$res = $serphouse->serpApi->get('77224195');
echo $res->getResponse();

```

{% endtab %}

{% tab title="JAVA" %}

```java
OkHttpClient client = new OkHttpClient().newBuilder().build();
Request request = new Request.Builder()
  .url("https://api.serphouse.com/serp/get?id=77224195")
  .get()
  .addHeader("Authorization", "Bearer <YOUR_API_KEY>")
  .build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
```

{% endtab %}

{% tab title="JAVASCRIPT" %}

```javascript
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <YOUR_API_KEY>");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://api.serphouse.com/serp/get?id=77224195", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
```

{% endtab %}

{% tab title="GO" %}

```go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.serphouse.com/serp/get?id=77224195"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

{% endtab %}

{% tab title="C#/.NET" %}

```csharp
var client = new RestClient("https://api.serphouse.com/serp/get?id=77224195");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <YOUR_API_KEY>");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```

{% endtab %}
{% endtabs %}