Google SERP API
Retrieve real-time Google search results programmatically with our fast and reliable Google SERP API.
Endpoint
GET https://vebapi.com/api/serp/google
Authentication
Include your API key in the request header:
X-API-KEY: YOUR_API_KEY
Request Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| q | string | Yes | The Google search query keyword or phrase. | laptop |
| locale | string | No | Locale for the Google search results. | en-us |
| device_type | string | No | Device type used for the search simulation. | desktop_chrome |
| page_count | integer | No | Number of result pages to retrieve. | 1 |
Example Request
curl -X GET "https://vebapi.com/api/serp/google?q=laptop&locale=en-us&device_type=desktop_chrome&page_count=1" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json"
Example Response
{
"engine": "Vebapi v8",
"node": "master",
"provider": "vebapi.com",
"request": {
"target": "google_serp",
"query": "laptop",
"locale": "en-us",
"device_type": "desktop_chrome"
},
"results": {
"results": [
{
"content": {
"results": {
"last_visible_page": 10,
"page": 1,
"parse_status_code": 12000,
"results": {
"ai_overviews": [],
"organic": [],
"organic_videos": [],
"paid": [],
"popular_products": [],
"related_questions": {},
"related_searches": [],
"search_information": {
"no_results_for_original_query_found": false,
"query": "laptop",
"showing_results_for": "laptop",
"time_taken_displayed": null,
"total_results_count": 1870000000
},
"total_results_count": 1870000000
},
"url": "https://www.google.com/search?q=laptop"
},
"errors": [],
"status_code": 12000,
"task_id": "7437524320433242113"
},
"headers": [],
"status_code": 200,
"task_id": "7437524320433242113",
"created_at": "2026-03-11 15:46:20",
"updated_at": "2026-03-11 15:46:24"
}
]
}
}
Top-Level Response Fields
| Field | Type | Description |
|---|---|---|
| engine | string | Version of the Vebapi engine handling the request. |
| node | string | Node name that processed the request. |
| provider | string | API provider name. |
| request | object | Echoed request metadata including target, query, locale, and device type. |
| results | object | Container for the returned SERP results. |
Request Object
| Field | Type | Description |
|---|---|---|
| target | string | Search target identifier. |
| query | string | The submitted search query. |
| locale | string | The locale used for result localization. |
| device_type | string | The device profile used for the request. |
Result Structure
The API returns a nested structure inside results.results[].content.results.results. Depending on the query, the following blocks may be present:
ai_overviews- AI-generated overview blocks when availableorganic- Standard organic search resultsorganic_videos- Video results from sources like YouTubepaid- Sponsored or paid search resultspopular_products- Shopping/product listingsrelated_questions- People also ask style question blocksrelated_searches- Related query suggestionssearch_information- Summary information about the search
Organic Result Object
| Field | Type | Description |
|---|---|---|
| title | string | Title of the organic result. |
| url | string | Destination URL. |
| url_shown | string | Displayed URL shown in search results. |
| desc | string | Description or snippet text. |
| favicon_text | string | Source or domain label. |
| pos | integer | Position within the organic block. |
| pos_overall | integer | Overall position on the results page. |
| rating | number | Rating value when available. |
| additional_info | array | Extra metadata such as ratings, shipping, or store information. |
Search Information Object
| Field | Type | Description |
|---|---|---|
| query | string | Original search query. |
| showing_results_for | string | The query Google is showing results for. |
| no_results_for_original_query_found | boolean | Whether no results were found for the original query. |
| time_taken_displayed | string|null | Displayed search time when available. |
| total_results_count | integer | Total estimated number of results returned by Google. |
Status Codes
| Field | Description |
|---|---|
| status_code | HTTP status for the API response. |
| parse_status_code | Internal parsing status code for the SERP extraction job. |
Device List
"device_types": [
"desktop",
"desktop_chrome",
"desktop_edge",
"desktop_firefox",
"desktop_opera",
"desktop_safari",
"mobile",
"mobile_android",
"mobile_ios",
"tablet",
"tablet_android",
"tablet_ios"
]
Geo Location and Language List
Notes
- The response may include different SERP blocks depending on the keyword, country, locale, and device type.
- Some sections such as AI Overviews, product listings, or related questions may be empty or unavailable for certain searches.
- Use
page_countto retrieve more result pages when supported. - All results are returned in JSON format for easy parsing and integration.