The longer answer is that you will find it extremely difficult to utilize any of the Google APIs to accomplish your objective. The Web Search API would have been your best bet, but it has three major flaws for your particular application. First, the TOS prohibit the use of applications which make automated queries. This makes automatic tracking of position - a staple of SEO - impossible. Second, the API only returns 8 results at a time and a maximum of 64 results total for any given query. So you could only check ranks out to the 64th place. And third, probably most problematic, the Web Search API does not return the same result set as a standard google.com search. This means that rankings retrieved from the API probably won't match exactly those returned from google.com. Add to all this the fact that the Web Search API was deprecated in November and scheduled for discontinuation in November 2014, and I would say it is a no-go.
The Custom Search API (CSAPI) is the closest alternative, but again, its limitations make it extremely impractical for SEO applications. First, it retains the same TOS clause against automated queries. Second, while the CSAPI will return more results, it is still limited to returning no more than 10 results at a time and a maximum of 100 results total for any given query. Moreover, it has a default rate limit of 100 queries per day, so you could only get all 100 results for 10 different search terms on a given day. And third, the CSAPI is restricted to working with a Custom Search Engine which you must set up and maintain, and which cannot search the entire web. So rankings retrieved using the CSAPI are essentially useless for real SEO operations.
The next option is to parse results from Google's web interface, but this is explicitly forbidden in Google's general TOS.
The bottom line is this: Google's official policy is to view SEO applications as bad for the company because they seek to end-run and ultimately could crack the search engine's secret sauce (a.k.a., Google's search algorithm). Therefore, they take a very dim view on SEO applications and great pains to deter SEO operators from utilizing the APIs.
If you're wanting to glean useful information about your site(s) rankings on Google, you may want to consider Google Analytics and Google Webmaster Tools. When used in conjunction with one another, they offer the ability to track rankings, popular search queries, and even how and when your site(s) are crawled by GoogleBot.
Jeremy R. Geerdes
Generally Cool Guy
Des Moines, IA
For more information or a project quote:
jrge...@gmail.com
If you're in the Des Moines, IA, area, check out Debra Heights Wesleyan Church!
> --
> You received this message because you are subscribed to the Google Groups "Google AJAX APIs" group.
> To post to this group, send email to google-ajax...@googlegroups.com.
> To unsubscribe from this group, send email to google-ajax-searc...@googlegroups.com.
> For more options, visit this group at http://groups.google.com/group/google-ajax-search-api?hl=en.
>
Jeremy R. Geerdes
Generally Cool Guy
Des Moines, IA
For more information or a project quote:
jrge...@gmail.com
If you're in the Des Moines, IA, area, check out Debra Heights Wesleyan Church!