# Google Ads Campaign Generator (by URL) (`acme-ai/google-ads-campaign-generator`) Actor
Turn any website URL into a complete, launch-ready Google Search campaign: themed ad groups, keywords with match types, Responsive Search Ads, extensions, negative keywords and bidding tips - all within Google's limits. Multi-language, one campaign per URL (by URL).
- **URL**: https://apify.com/acme-ai/google-ads-campaign-generator.md
- **Developed by:** [Acme AI](https://apify.com/acme-ai) (community)
- **Categories:** Social media, Lead generation, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1,000.00 / 1,000 charged for each campaigns
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## đ¯ Google Ads Campaign Generator (by URL)
Turn **any website URL** into a complete, launch-ready **Google Search campaign**. Point it at a site and our AI content engine reads the page, understands the business, and builds the whole campaign for you - one full campaign per URL.
> đ **From URL to campaign.** No briefs, no blank page. Paste a website, pick a language, get a ready-to-launch structure you can paste straight into Google Ads.
**đ Every run ships a branded, client-ready report** - the real highlight. Share it as a link or email it: the whole campaign laid out for stakeholders, not just raw JSON.
[](https://api.apify.com/v2/key-value-stores/I8KX62PBaRQ0kOeaa/records/google-ads-campaign-report-full.png?signature=Iet6idH1CNP3cMVeekHu)
> Preview of the HTML report - company analysis, ICP, ad groups, extensions and recommendations. Click to open the full report.
---
#### đ What does it do?
For each URL you provide, the actor crawls the site and returns a structured campaign:
- **Company analysis** - what they do, value proposition, products, tone and industry.
- **Ideal customer profile (ICP)** - persona, pains, triggers, objections and the search your buyer actually types.
- **3 to 5 themed ad groups** - each a different search intent, with **8 to 15 keywords** and the right **match type** (exact / phrase / broad).
- **One Responsive Search Ad (RSA) per ad group** - **10 to 15 headlines** and **4 descriptions**, all within Google's character limits.
- **Ad extensions** - sitelinks, callouts and structured snippets.
- **Negative keywords** - terms to exclude so you don't waste budget.
- **Optimization tips** - campaign type, budget, bidding and best times to run.
Every text field is validated against Google's limits in code; anything too long is trimmed and the row is flagged (`trimmed: true`).
> âšī¸ The audience, timing and bidding recommendations are AI best-practice **suggestions**, not measured performance data.
#### 𧊠Plus a branded HTML report
Each campaign is also rendered as a **branded HTML report** (saved to the Key-Value Store, returned as a public `reportUrl`) with the company summary, ICP, every ad group and the recommendations. Fill in the optional `emails` field to have it **emailed** automatically.
---
#### đ¯ Why use it?
- **Launch faster** - go from a landing page to a campaign draft in minutes.
- **Agencies** - spin up first-draft campaigns for new clients straight from their site.
- **Go multi-language** - generate the same site in English, Spanish, Portuguese and more.
- **Refresh accounts** - benchmark and rebuild a stale campaign structure.
---
#### đ How to use
1. Add one or more **website URLs**.
2. Pick an **output language** (or leave `auto` to match the site).
3. *(Optional)* add **emails** to receive the HTML report.
4. Click **Start**. You get one campaign per URL.
Prefer real time? Call the Standby endpoint `POST /generate` (see API integration below).
---
#### đ˛ Pricing
Pay per result: you are charged once per URL for which a campaign is generated (`campaign-generated`). **URLs that fail or can't be processed are not charged.**
---
#### đĨ Input
```json
{
"urls": ["https://www.apify.com"],
"language": "en",
"emails": []
}
````
| Field | Required | Description |
|---|---|---|
| `urls` | yes | Websites to analyze. One full campaign per URL (max 20). |
| `language` | no | `auto`, `en`, `pt-BR`, `es`, `fr`, `de`, `it`. Default `auto`. |
| `emails` | no | Send the branded HTML report to these addresses. |
***
#### đ¤ Output
One record per URL. Example (arrays trimmed for brevity):
```json
{
"url": "https://www.apify.com",
"language": "en",
"success": true,
"company": {
"name": "Apify",
"whatTheyDo": "Full-stack web scraping and browser automation platform.",
"industry": "Web scraping / automation"
},
"icp": {
"persona": "Developers and data teams who need reliable web data.",
"searchIntent": "web scraping api"
},
"adGroups": [
{
"name": "Web Scraping Platform",
"theme": "Category",
"keywords": [
{ "text": "web scraping platform", "matchType": "phrase" },
{ "text": "web scraping api", "matchType": "exact" }
],
"rsa": {
"headlines": ["Scrape Any Website", "Automate Data Extraction", "Start Free Today"],
"descriptions": ["Extract data from any site at scale with ready-made tools.", "Reliable proxies and storage built in. Try it free."],
"paths": ["scraping", "api"],
"finalUrl": "https://www.apify.com"
}
}
],
"extensions": {
"sitelinks": [{ "text": "Browse Actors", "description1": "Thousands of ready tools", "description2": "Run them in one click" }],
"callouts": ["Free to start", "No credit card", "Cloud-based"],
"structuredSnippets": { "header": "Features", "values": ["Actors", "Proxy", "Storage", "Scheduler"] }
},
"negativeKeywords": ["free", "jobs", "tutorial", "course"],
"insights": {
"campaignType": "Search",
"budgetTip": "Start small and scale the ad groups with the lowest CPA.",
"biddingTip": "Begin on Maximize Clicks, then move to Target CPA once you have data."
},
"trimmed": false,
"reportUrl": "https://api.apify.com/v2/key-value-stores/XXXX/records/report-...&signature=...",
"generatedAt": "2026-06-10T12:00:00.000Z",
"error": null
}
```
A URL that can't be processed comes back with `success: false` and a filled `error`. See the **Dataset schema** tab for the full field list.
***
#### â FAQ
**What is the reportUrl?**
A public, signed link to a branded HTML campaign report (ICP, all ad groups, recommendations). It opens in any browser, no token needed.
**Will the copy fit Google Ads?**
Yes. The character limits are enforced in code; anything over is trimmed and the row is flagged with `trimmed: true`.
**Are the recommendations real performance data?**
No - they are AI best-practice **suggestions** to use as a starting point. Validate against your own campaign data.
**Can I process many sites at once?**
Yes - up to 20 URLs per run, one campaign each.
**Can I call it in real time?**
Yes. The Standby endpoint `POST /generate` responds synchronously.
***
#### đ API integration
**Batch run:**
```bash
curl -X POST "https://api.apify.com/v2/acts/acme-ai~google-ads-campaign-generator/run-sync-get-dataset-items?token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.apify.com"],"language":"en","emails":["you@company.com"]}'
```
**Standby (`POST /generate`):**
```bash
curl -X POST "https://acme-ai--google-ads-campaign-generator.apify.actor/generate" \
-H "Authorization: Bearer YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
--compressed \
-d '{"urls":["https://www.apify.com"],"language":"en"}'
```
The token goes in the `Authorization: Bearer` header, never in the URL.
***
#### đ Related actors
- [AI Google Ads Generator](https://apify.com/acme-ai/ai-google-ads-generator) - generate many **RSA ad copy variations** from a short product description and offer (text in, ads out), when you don't have a URL.
***
#### đ Notes
Generated ad copy and recommendations are provided as a starting point and are not guarantees of performance. Always review the copy and comply with Google Ads policies before publishing.
# Actor input Schema
## `urls` (type: `array`):
The website(s) to analyze. We crawl each one and generate a complete Google Ads campaign per URL. Add one or more public URLs, e.g. \["https://www.apify.com"]. Up to 20 per run.
## `language` (type: `string`):
Language of the generated ads and report. Use auto to detect the site's own language, or pick one. The same site can be generated in different languages across runs.
## `emails` (type: `array`):
Optional. Send the branded HTML campaign report to these email addresses, e.g. \["you@company.com"].
## Actor input object example
```json
{
"urls": [
"https://www.apify.com"
],
"language": "auto"
}
```
# Actor output Schema
## `campaigns` (type: `string`):
Generated campaigns (one record per URL).
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"urls": [
"https://www.apify.com"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("acme-ai/google-ads-campaign-generator").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`đž Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// đ Want to learn more đ? Go to â https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "urls": ["https://www.apify.com"] }
# Run the Actor and wait for it to finish
run = client.actor("acme-ai/google-ads-campaign-generator").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("đž Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# đ Want to learn more đ? Go to â https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"urls": [
"https://www.apify.com"
]
}' |
apify call acme-ai/google-ads-campaign-generator --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=acme-ai/google-ads-campaign-generator",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Campaign Generator (by URL)",
"description": "Turn any website URL into a complete, launch-ready Google Search campaign: themed ad groups, keywords with match types, Responsive Search Ads, extensions, negative keywords and bidding tips - all within Google's limits. Multi-language, one campaign per URL (by URL).",
"version": "1.0",
"x-build-id": "34Bby0TPqXTHg1eSP"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/acme-ai~google-ads-campaign-generator/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-acme-ai-google-ads-campaign-generator",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/acme-ai~google-ads-campaign-generator/runs": {
"post": {
"operationId": "runs-sync-acme-ai-google-ads-campaign-generator",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/acme-ai~google-ads-campaign-generator/run-sync": {
"post": {
"operationId": "run-sync-acme-ai-google-ads-campaign-generator",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"urls"
],
"properties": {
"urls": {
"title": "đ Website URLs",
"minItems": 1,
"maxItems": 20,
"type": "array",
"description": "The website(s) to analyze. We crawl each one and generate a complete Google Ads campaign per URL. Add one or more public URLs, e.g. [\"https://www.apify.com\"]. Up to 20 per run.",
"items": {
"type": "string"
}
},
"language": {
"title": "đŖī¸ Output language",
"enum": [
"auto",
"en",
"pt-BR",
"es",
"fr",
"de",
"it"
],
"type": "string",
"description": "Language of the generated ads and report. Use auto to detect the site's own language, or pick one. The same site can be generated in different languages across runs.",
"default": "auto"
},
"emails": {
"title": "đ§ Email report to (optional)",
"type": "array",
"description": "Optional. Send the branded HTML campaign report to these email addresses, e.g. [\"you@company.com\"].",
"items": {
"type": "string"
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```