Google

Google Ads API

Retrieve Google Search ad results. ads_available is false when the valid search page contains no ads.

Try in the request builder API reference Connect with MCP

Make a request

Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.

POST /v1/google/ads

curl 'https://api.prismcrawl.com/v1/google/ads' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "query": "car insurance"
}'

Supported parameters

Parameter	Usage
`query`Required	Text to search for on the selected service.
`country`	Two-letter country or storefront code, such as us or gb.
`language`	Provider-supported language code, such as en.
`location`	Location to search around, such as Austin, TX.
`device`	Device presentation for the source request. desktop, mobile, tablet
`html`	Return the encoded original response rather than parsed JSON.
`zero_trace`	Do not archive source or parsed response artifacts.
`coordinates`	Latitude and longitude for location targeting.
`safe`	Provider safe-search filtering. active, off
`nfpr`	Control automatic spelling correction (1 excludes corrected results). 0, 1

Structured results

Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.

addresscategorycoordinatesdescriptionidlatitudelongitudenamephonepositionrankratingrating_maxrating_sourcereview_countsnippetthumbnailtitletracking_urltypeurlwebsite

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.

Python SDK: pip install prismcrawl
Node.js SDK: npm install prismcrawl