# Google Ads Affiliate Checker — Ad Links & Redirects (`junipr/google-ads-affiliate-checker`) Actor Detect sponsored results, affiliate links, redirects, tracking domains, and ad landing pages from supplied SERP snapshots or controlled live checks. - **URL**: https://apify.com/junipr/google-ads-affiliate-checker.md - **Developed by:** [junipr](https://apify.com/junipr) (community) - **Categories:** SEO tools - **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $8.20 / 1,000 ad checkeds 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 Affiliate Checker — Ad Links & Redirects Detect sponsored results, affiliate links, redirects, tracking domains, and ad landing pages from supplied SERP snapshots or controlled live checks. ### What this actor does Detect sponsored results, affiliate links, redirects, tracking domains, and ad landing pages from supplied SERP snapshots or controlled live checks. The actor is configured for public or user-supplied sources, evidence-backed output rows, capped runs, and KVS summaries for blocked, empty, duplicate, or capped work. ### What you can use it for - Build repeatable google ads affiliate checker datasets for analysis and automation. - Export records with source URLs, evidence fields, and run summaries. - Run buyer-ready tasks for: Audit SERP ad links for affiliate redirects; Check landing-page redirect chains; Analyze sponsored results from SERP snapshots. Search-intent terms: google ads affiliate checker, affiliate link checker, ad detection, paid search monitoring, redirect checker, SERP ads. ### Inputs The input schema supports the actor's source fields plus cost and quality controls. Important caps include `keywords`, `country`, `language`, `location`, `maxRedirects`, `includeOrganicResults`, `proxyConfiguration`. Public task examples below provide small, safe starting inputs. ### Outputs Paid dataset rows and paid KVS artifacts are written only after the configured PPE charge succeeds. Rows include source/evidence fields where the actor can determine them and avoid fabricated values. ### Key-value store reports Every run writes `SUMMARY.md` and `SUMMARY.json`. Diagnostic CSV or JSON reports are used for blocked pages, no-result pages, duplicates, unsupported inputs, and capped runs instead of paid dataset rows. ### Pricing This actor uses pay-per-event pricing with Apify platform usage included in the event prices. Store discount tiers are configured for FREE, BRONZE, SILVER, and GOLD users. | Event | Unit | FREE | BRONZE | SILVER | GOLD | |---|---:|---:|---:|---:|---:| | `actor-start` | run | $0.05000 | $0.05000 | $0.04500 | $0.04000 | | `serp-page-rendered` | page | $0.01719 | $0.01719 | $0.01547 | $0.01375 | Primary paid output event: `serp-page-rendered`. Runtime-paid dataset rows and runtime-paid artifacts use this active paid-output event unless a future pricing revision adds an actor-specific artifact boundary with matching code. ### Cost controls and max-charge behavior Default max charge: $50.00. When the run reaches the max charge or an event-charge limit, it stops gracefully and writes free summary diagnostics without adding unpaid dataset rows. ### Platform usage / proxy / browser / API notes The configured model is fixed-inclusive PPE: platform usage is included in event prices and the platform-usage pass-through toggle is off. Features that require browser rendering, proxies, provider APIs, or additional fetches are bounded by the input caps and priced through explicit events. ### Reliability notes and limitations The actor processes public or permissioned inputs only. Blocked pages, login walls, unsupported formats, empty results, and provider errors are recorded as diagnostics. The actor does not fabricate rankings, prices, reviews, sentiment, traffic, compliance status, or private contact data when source evidence is unavailable. ### Example inputs ```json { "keywords": [ "Audit SERP ad links for affiliate redirects" ], "country": "US", "language": "en", "location": "", "followRedirects": false, "maxRedirects": 3, "detectCloaking": false, "checkLandingPage": false, "customAffiliatePatterns": [], "includeOrganicResults": false, "includeAdCopy": true, "onlyAffiliateAds": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxChargeUsd": 10, "debugMode": false, "saveRawHtmlToKvs": false, "requestTimeout": 30000, "maxRetries": 1, "maxConcurrency": 1, "serpMode": "suppliedSnapshot", "suppliedSerpSnapshots": [], "sourceMode": "livePublic", "suppliedSnapshotHtml": "google ads affiliate checker", "suppliedSnapshotJson": "google ads affiliate checker", "suppliedSnapshotText": "google ads affiliate checker" } ```` ### Public task examples - Audit SERP ad links for affiliate redirects: Dataset rows matching the audit serp ad links for affiliate redirects use case, plus SUMMARY.md and SUMMARY.json reports in the key-value store. - Check landing-page redirect chains: Dataset rows matching the check landing-page redirect chains use case, plus SUMMARY.md and SUMMARY.json reports in the key-value store. - Analyze sponsored results from SERP snapshots: Dataset rows matching the analyze sponsored results from serp snapshots use case, plus SUMMARY.md and SUMMARY.json reports in the key-value store. ### Ethical/allowed-use notes Use this actor only for public data, owned files, or sources you have permission to process. Respect source terms, privacy expectations, robots guidance, and applicable laws. Do not use the actor to collect secrets, bypass access controls, or make unsupported legal, financial, medical, or compliance decisions. # Actor input Schema ## `keywords` (type: `array`): Keywords to check Google Ads for. Max 100 keywords per run. ## `country` (type: `string`): Country code for Google search (ISO 3166-1 alpha-2, e.g., US, GB, DE). Affects which ads are shown. ## `language` (type: `string`): Language code for Google search (ISO 639-1, e.g., en, es, fr). ## `location` (type: `string`): Specific location for geo-targeted ads (e.g., 'New York, NY', 'London'). Leave empty for country-level results. ## `followRedirects` (type: `boolean`): Follow redirect chains to find final destination URL. Required for affiliate detection. ## `maxRedirects` (type: `integer`): Maximum number of redirects to follow per ad link (1-20). ## `detectCloaking` (type: `boolean`): Detect URL cloaking techniques (JavaScript redirects, meta refresh, iframe wraps). ## `checkLandingPage` (type: `boolean`): Load the final landing page to check for additional affiliate markers (cookies, scripts). ## `customAffiliatePatterns` (type: `array`): Additional URL patterns to detect as affiliate links (regex strings). Use for private/custom affiliate networks. ## `includeOrganicResults` (type: `boolean`): Also capture organic results for context (top 10). ## `includeAdCopy` (type: `boolean`): Include the ad headline and description text in output. ## `onlyAffiliateAds` (type: `boolean`): Only output ads detected as affiliate links (filter out direct advertiser ads). ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies are required — Google blocks datacenter IPs for SERP scraping. ## `maxChargeUsd` (type: `number`): Stop before paid output would exceed the configured max charge. ## `debugMode` (type: `boolean`): Write extra free diagnostics to the key-value store. ## `saveRawHtmlToKvs` (type: `boolean`): Save raw snapshots as free debug artifacts when enabled. ## `requestTimeout` (type: `integer`): Maximum time to wait for a request or page load. ## `maxRetries` (type: `integer`): Maximum retry attempts per source. ## `maxConcurrency` (type: `integer`): Maximum concurrent requests. High-risk marketplace and SERP actors default to a low value. ## `serpMode` (type: `string`): Use suppliedSnapshot by default. Provider mode requires an approved SERP provider key. Direct live Google scraping is not the default. ## `suppliedSerpSnapshots` (type: `array`): SERP snapshot objects with keyword and html/providerJson fields. ## `serpProviderApiKey` (type: `string`): API key for approved provider mode. ## `sourceMode` (type: `string`): Use public live targets, supplied snapshots, or provider-backed source data when supported. ## `suppliedSnapshotHtml` (type: `string`): Optional HTML snapshot for deterministic public-data extraction tests or controlled source capture. ## `suppliedSnapshotJson` (type: `string`): Optional JSON snapshot/provider response for deterministic public-data extraction tests or controlled source capture. ## `suppliedSnapshotText` (type: `string`): Optional plain text snapshot for text-analysis actors. ## Actor input object example ```json { "keywords": [ "best vpn service" ], "country": "US", "language": "en", "location": "", "followRedirects": false, "maxRedirects": 3, "detectCloaking": false, "checkLandingPage": false, "customAffiliatePatterns": [], "includeOrganicResults": false, "includeAdCopy": true, "onlyAffiliateAds": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxChargeUsd": 50, "debugMode": false, "saveRawHtmlToKvs": false, "requestTimeout": 30000, "maxRetries": 1, "maxConcurrency": 1, "serpMode": "suppliedSnapshot", "suppliedSerpSnapshots": [], "sourceMode": "livePublic" } ``` # Actor output Schema ## `results` (type: `string`): Per-ad Google Ads affiliate link detection results with redirect chains, network identification, and cloaking analysis. ## `summary` (type: `string`): Billing, paid row, diagnostic, duplicate, and artifact summary. ## `runStatus` (type: `string`): Free diagnostic run status, including no-result and blocked-page counters. ## `kvsArtifacts` (type: `string`): Actor-specific CSV/JSON/Markdown report artifacts. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("junipr/google-ads-affiliate-checker").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 = {} # Run the Actor and wait for it to finish run = client.actor("junipr/google-ads-affiliate-checker").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 '{}' | apify call junipr/google-ads-affiliate-checker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=junipr/google-ads-affiliate-checker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Ads Affiliate Checker — Ad Links & Redirects", "description": "Detect sponsored results, affiliate links, redirects, tracking domains, and ad landing pages from supplied SERP snapshots or controlled live checks.", "version": "1.0", "x-build-id": "5iaeo0oBwHObiokle" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/junipr~google-ads-affiliate-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-junipr-google-ads-affiliate-checker", "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/junipr~google-ads-affiliate-checker/runs": { "post": { "operationId": "runs-sync-junipr-google-ads-affiliate-checker", "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/junipr~google-ads-affiliate-checker/run-sync": { "post": { "operationId": "run-sync-junipr-google-ads-affiliate-checker", "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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to check Google Ads for. Max 100 keywords per run.", "default": [ "best vpn service" ], "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Country code for Google search (ISO 3166-1 alpha-2, e.g., US, GB, DE). Affects which ads are shown.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language code for Google search (ISO 639-1, e.g., en, es, fr).", "default": "en" }, "location": { "title": "Location", "type": "string", "description": "Specific location for geo-targeted ads (e.g., 'New York, NY', 'London'). Leave empty for country-level results.", "default": "" }, "followRedirects": { "title": "Follow Redirects", "type": "boolean", "description": "Follow redirect chains to find final destination URL. Required for affiliate detection.", "default": false }, "maxRedirects": { "title": "Max Redirects", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of redirects to follow per ad link (1-20).", "default": 3 }, "detectCloaking": { "title": "Detect Cloaking", "type": "boolean", "description": "Detect URL cloaking techniques (JavaScript redirects, meta refresh, iframe wraps).", "default": false }, "checkLandingPage": { "title": "Check Landing Page", "type": "boolean", "description": "Load the final landing page to check for additional affiliate markers (cookies, scripts).", "default": false }, "customAffiliatePatterns": { "title": "Custom Affiliate Patterns", "type": "array", "description": "Additional URL patterns to detect as affiliate links (regex strings). Use for private/custom affiliate networks.", "default": [], "items": { "type": "string" } }, "includeOrganicResults": { "title": "Include Organic Results", "type": "boolean", "description": "Also capture organic results for context (top 10).", "default": false }, "includeAdCopy": { "title": "Include Ad Copy", "type": "boolean", "description": "Include the ad headline and description text in output.", "default": true }, "onlyAffiliateAds": { "title": "Only Affiliate Ads", "type": "boolean", "description": "Only output ads detected as affiliate links (filter out direct advertiser ads).", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are required — Google blocks datacenter IPs for SERP scraping.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxChargeUsd": { "title": "Max Charge USD", "minimum": 0, "type": "number", "description": "Stop before paid output would exceed the configured max charge.", "default": 50 }, "debugMode": { "title": "Debug Mode", "type": "boolean", "description": "Write extra free diagnostics to the key-value store.", "default": false }, "saveRawHtmlToKvs": { "title": "Save Raw HTML to KVS", "type": "boolean", "description": "Save raw snapshots as free debug artifacts when enabled.", "default": false }, "requestTimeout": { "title": "Request Timeout (ms)", "minimum": 1000, "maximum": 120000, "type": "integer", "description": "Maximum time to wait for a request or page load.", "default": 30000 }, "maxRetries": { "title": "Max Retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Maximum retry attempts per source.", "default": 1 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 3, "type": "integer", "description": "Maximum concurrent requests. High-risk marketplace and SERP actors default to a low value.", "default": 1 }, "serpMode": { "title": "SERP Mode", "enum": [ "suppliedSnapshot", "provider" ], "type": "string", "description": "Use suppliedSnapshot by default. Provider mode requires an approved SERP provider key. Direct live Google scraping is not the default.", "default": "suppliedSnapshot" }, "suppliedSerpSnapshots": { "title": "Supplied SERP Snapshots", "type": "array", "description": "SERP snapshot objects with keyword and html/providerJson fields.", "items": { "type": "object" }, "default": [] }, "serpProviderApiKey": { "title": "SERP Provider API Key", "type": "string", "description": "API key for approved provider mode." }, "sourceMode": { "title": "Source Mode", "enum": [ "livePublic", "suppliedSnapshot", "provider" ], "type": "string", "description": "Use public live targets, supplied snapshots, or provider-backed source data when supported.", "default": "livePublic" }, "suppliedSnapshotHtml": { "title": "Supplied Snapshot HTML", "type": "string", "description": "Optional HTML snapshot for deterministic public-data extraction tests or controlled source capture." }, "suppliedSnapshotJson": { "title": "Supplied Snapshot JSON", "type": "string", "description": "Optional JSON snapshot/provider response for deterministic public-data extraction tests or controlled source capture." }, "suppliedSnapshotText": { "title": "Supplied Snapshot Text", "type": "string", "description": "Optional plain text snapshot for text-analysis actors." } } }, "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 } } } } } } } } } } ```