Search APIs
Loading…
← API Store
Search & SEO

Google

Google

Google search ads

GET /google/v1/ads
Test this endpoint

Only the paid results (ads) on a Google results page, top and bottom blocks: title, landing page link, displayed link, domain, advertiser, description, sitelinks (with their landing pages when the ad carries them), position, block (top or bottom) and position within the block. An empty ads list means Google showed no ads for that query and place. Ads depend on country and location. Pass next_page back as page for the ads of later result pages. Every response includes credits_used: the credits this call cost.

Each call costs 2 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: car insurance
pagestringResults page. Example: 1
countrystringResults country (gl), e.g. us, gb, de.
languagestringInterface language (hl), e.g. en, de.
locationstringCity/region to search from, e.g. Austin,Texas,United States.
google_domainstringe.g. google.co.uk.
safestringon or off.
devicedesktop | mobiledesktop or mobile.

Every endpoint also takes: raw、fields、fresh、output、records

No sample yet

This endpoint has no published sample. Use “Test this endpoint” to run it in the console playground.