API Reference

Google Ads

Search Google and retrieve paid advertisement results with title, URL, displayed URL, and description. Supports pagination and geographic targeting.

Use this to see what paid ads appear for a search query — useful for competitive intelligence, ad copy research, and monitoring your own brand terms.

5 credits per request.

Quick example

curl -G "https://api.webscraperapi.ai/v1/google_ads" \
  -H "Authorization: Bearer $WEBSCRAPERAPI_API_KEY" \
  --data-urlencode "query=project management software" \
  --data-urlencode "output=json"

Pair with SERP Domain Frequencies to see which competitors dominate both paid and organic results for your target keywords.

Full API reference

GET
/v1/google_ads

Query Parameters

query*string

Search query.

Length1 <= length
domain?|

Google domain TLD (e.g., 'com', 'de', 'co.uk').

locale?|

Interface language in IETF BCP 47 (e.g., 'en-US').

geo_location?|

Geographic location (e.g., 'California,United States').

start_page?integer

Starting page number.

Default1
pages?integer

Number of pages to scrape.

Default1
render_js?boolean

Whether to render JavaScript.

Defaultfalse
output?|

Output format.

Default"markdown"
timeout_ms?|

Request timeout in milliseconds.

Response Body

application/json

application/json

curl -X GET "https://api.webscraperapi.ai/v1/google_ads?query=string"
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Google Shopping Search

Search Google Shopping for product listings with prices, merchant info, and actual product URLs. Supports currency, language, and geographic targeting.

SERP Domain Frequencies

Analyze Google Shopping results to count how often each domain appears. Useful for competitive analysis and market research.