Google Search API

Welcome to AvesAPI!

Getting Started

The AvesAPI was built to let you scrape Google SERP data in real-time removing the complexity of managing proxy and solving CAPTCHA challenges. The application takes only a few minutes using the simple HTTP GET URL structure, and the results are returned as JSON or HTML.

AvesAPI is based on REST technology to interact with data between your application and our service.

This documentation will outline in detail specifications, access, and available API endpoints. In case any technical questions are left unanswered, please feel free to contact AvesAPI support for assistance.

Prohibited Keywords

We deduct 1 credit per each successful request except for some restrictions in order to maintain our service sustainable. All operator search is strictly prohibited and if you make such query, 25 credits will be deducted. Some of them are listed below

site: , inurl: , domain: , link: , title: , intitle: , intext: , allintext: , cache: , before: , after:

API Access Key & Authentication

After signing up for an account, each user will be assigned a unique API Access Key. This key will be used to authenticate with the API via REST and access any of the available endpoints.

If you are a current user of AvesAPI, obtain the API Key from your account page to access our API. If you are not a member of AvesAPI you can create your account to benefit from our service.

To authenticate with the API, simply append your API key to the API's base URL using the apikey parameter shown below.

Common API Error Codes

The response will be returned as 400 Status code If there is a problem with your request.

API Endpoints

To query the API for Google search results, simply append the query parameter to the API's base URL and set it to a search query of your choice.

Example request:

HTTP Get Requests Parameters

Response and Definitions

Your API response strongly depends on your search query and the parameters you choose to make use of. Find below a representative example API response, returned for the query adidas and containing some of Google's key response objects. Each available response object will be explained further below in this section.

Response Object:

Last updated