# Bulk UTM & Redirect QA Checker (`s3nafps/utm-redirect-qa-checker`) Actor Check campaign URLs in bulk for missing UTM parameters, redirects, HTTP status codes, final landing URLs, and page titles. Built for marketers, PPC teams, email teams, and SEO agencies. - **URL**: https://apify.com/s3nafps/utm-redirect-qa-checker.md - **Developed by:** [mohamed senator](https://apify.com/s3nafps) (community) - **Categories:** Marketing, SEO tools, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.20 / 1,000 checked urls This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Bulk UTM & Redirect QA Checker Check marketing campaign URLs in bulk before they go live. This Apify Actor follows redirects, verifies required UTM parameters, records the final landing URL, checks the HTTP status code, and extracts the final page title when available. ### What does this Actor do? Bulk UTM & Redirect QA Checker helps marketers, PPC teams, SEO agencies, email teams, and no-code operators catch common campaign URL problems: - Missing `utm_source`, `utm_medium`, or `utm_campaign` - Blank UTM values such as `utm_medium=` - Unexpected redirects - Broken or unreachable landing pages - Final URLs that differ from the original campaign URL - Missing or unexpected page titles The Actor uses only public URLs that you provide. It does not log into websites, bypass CAPTCHA, collect private data, or use mock output. ### Typical use cases - QA links before sending an email newsletter - Check ad destination URLs before launch - Audit campaign links exported from a spreadsheet - Verify redirect chains after a website migration - Find landing pages where UTM parameters are lost during redirects ### Input #### URLs to check Add one or more public `http://` or `https://` URLs. Local, private-network, malformed, and non-HTTP URLs are rejected. #### Required UTM parameters By default, the Actor requires: - `utm_source` - `utm_medium` - `utm_campaign` You can also require `utm_term` and/or `utm_content`. #### Maximum URLs to check `maxResults` limits how many unique input URLs are checked. Duplicate URLs are removed before processing. #### Redirect and timeout settings Use `maxRedirects` and `requestTimeoutSecs` to control how tolerant the Actor should be when pages are slow or redirect many times. ### Example input ```json { "startUrls": [ { "url": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=spring-sale" }, { "url": "https://www.iana.org/?utm_source=partner&utm_medium=referral&utm_campaign=launch" } ], "requiredUtmParams": ["utm_source", "utm_medium", "utm_campaign"], "maxResults": 100, "maxRedirects": 10, "requestTimeoutSecs": 20, "includePageTitle": true } ```` ### Output Each checked URL is saved as one item in the Apify Dataset. Important fields: | Field | Meaning | |---|---| | `originalUrl` | URL you provided | | `finalUrl` | URL after redirects | | `statusCode` | Final HTTP status code if reached | | `ok` | `true` for successful 2xx/3xx final status without request error | | `redirectCount` | Number of redirects followed | | `redirectChain` | URLs visited through redirects | | `utmSource`, `utmMedium`, `utmCampaign`, `utmTerm`, `utmContent` | Parsed UTM values from the final URL | | `missingUtmParams` | Required UTM parameters that are absent or blank | | `hasRequiredUtmParams` | `true` if all required UTM parameters are present and non-empty | | `title` | Final page title when available | | `error` | Clear error message if the URL could not be checked | | `checkedAt` | ISO timestamp of the check | ### Example output ```json { "originalUrl": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=spring-sale", "finalUrl": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=spring-sale", "statusCode": 200, "ok": true, "redirectCount": 0, "redirectChain": [], "utmSource": "newsletter", "utmMedium": "email", "utmCampaign": "spring-sale", "utmTerm": null, "utmContent": null, "missingUtmParams": [], "hasRequiredUtmParams": true, "title": "Example Domain", "error": null, "checkedAt": "2026-07-04T00:00:00.000Z" } ``` ### Limitations - The Actor checks public URLs only. - It does not bypass bot protection, login walls, cookie banners, or CAPTCHA. - Some websites block automated requests; those URLs will return an error instead of fake success. - Page title extraction works only when the final response contains parseable HTML. - This is a campaign URL QA utility, not a full SEO crawler or security scanner. ### Suggested Pay Per Event pricing Recommended primary event: one checked URL / default dataset item. Suggested launch price: **$0.20 per 1,000 checked URLs** plus Apify platform usage costs. This keeps the Actor inexpensive for marketers while still monetizing recurring QA runs. ### SEO title suggestion Bulk UTM & Redirect QA Checker - Campaign URL Audit API ### SEO description suggestion Check campaign URLs in bulk for missing UTM parameters, redirects, HTTP status codes, final landing URLs, and page titles. Built for marketers, PPC teams, and SEO agencies. ### Support and maintenance If a URL fails, check the `error` field first. Common causes are invalid URLs, target timeouts, too many redirects, DNS issues, or public websites blocking automated requests. For reliable automated monitoring, keep default runs small and schedule recurring tests with your most important campaign URLs. # Actor input Schema ## `startUrls` (type: `array`): Public marketing URLs to check. Each URL must start with http:// or https://. ## `requiredUtmParams` (type: `array`): UTM parameters that must be present and non-empty on the final landing URL. ## `maxResults` (type: `integer`): Stops after this many unique input URLs. ## `maxRedirects` (type: `integer`): Fails a URL if it redirects more than this many times. ## `requestTimeoutSecs` (type: `integer`): How long to wait for each URL before recording a timeout error. ## `includePageTitle` (type: `boolean`): Fetch and parse the final HTML page title when available. ## Actor input object example ```json { "startUrls": [ { "url": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=apify-default" }, { "url": "https://www.iana.org/?utm_source=partner&utm_medium=referral&utm_campaign=apify-default" }, { "url": "https://docs.apify.com/?utm_source=social&utm_medium=post&utm_campaign=apify-default" } ], "requiredUtmParams": [ "utm_source", "utm_medium", "utm_campaign" ], "maxResults": 3, "maxRedirects": 10, "requestTimeoutSecs": 20, "includePageTitle": true } ``` # Actor output Schema ## `results` (type: `string`): Open the default dataset in Apify Console. The dataset schema selects a clean table view with the most useful fields first. # 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 = { "startUrls": [ { "url": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=apify-default" }, { "url": "https://www.iana.org/?utm_source=partner&utm_medium=referral&utm_campaign=apify-default" }, { "url": "https://docs.apify.com/?utm_source=social&utm_medium=post&utm_campaign=apify-default" } ], "requiredUtmParams": [ "utm_source", "utm_medium", "utm_campaign" ], "maxResults": 3, "maxRedirects": 10, "requestTimeoutSecs": 20, "includePageTitle": true }; // Run the Actor and wait for it to finish const run = await client.actor("s3nafps/utm-redirect-qa-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 = { "startUrls": [ { "url": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=apify-default" }, { "url": "https://www.iana.org/?utm_source=partner&utm_medium=referral&utm_campaign=apify-default" }, { "url": "https://docs.apify.com/?utm_source=social&utm_medium=post&utm_campaign=apify-default" }, ], "requiredUtmParams": [ "utm_source", "utm_medium", "utm_campaign", ], "maxResults": 3, "maxRedirects": 10, "requestTimeoutSecs": 20, "includePageTitle": True, } # Run the Actor and wait for it to finish run = client.actor("s3nafps/utm-redirect-qa-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 '{ "startUrls": [ { "url": "https://example.com/?utm_source=newsletter&utm_medium=email&utm_campaign=apify-default" }, { "url": "https://www.iana.org/?utm_source=partner&utm_medium=referral&utm_campaign=apify-default" }, { "url": "https://docs.apify.com/?utm_source=social&utm_medium=post&utm_campaign=apify-default" } ], "requiredUtmParams": [ "utm_source", "utm_medium", "utm_campaign" ], "maxResults": 3, "maxRedirects": 10, "requestTimeoutSecs": 20, "includePageTitle": true }' | apify call s3nafps/utm-redirect-qa-checker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=s3nafps/utm-redirect-qa-checker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bulk UTM & Redirect QA Checker", "description": "Check campaign URLs in bulk for missing UTM parameters, redirects, HTTP status codes, final landing URLs, and page titles. Built for marketers, PPC teams, email teams, and SEO agencies.", "version": "0.1", "x-build-id": "Q0G3QouzGNVTmQxVh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s3nafps~utm-redirect-qa-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s3nafps-utm-redirect-qa-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/s3nafps~utm-redirect-qa-checker/runs": { "post": { "operationId": "runs-sync-s3nafps-utm-redirect-qa-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/s3nafps~utm-redirect-qa-checker/run-sync": { "post": { "operationId": "run-sync-s3nafps-utm-redirect-qa-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "URLs to check", "type": "array", "description": "Public marketing URLs to check. Each URL must start with http:// or https://.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "requiredUtmParams": { "title": "Required UTM parameters", "type": "array", "description": "UTM parameters that must be present and non-empty on the final landing URL.", "default": [ "utm_source", "utm_medium", "utm_campaign" ], "items": { "type": "string" } }, "maxResults": { "title": "Maximum URLs to check", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stops after this many unique input URLs.", "default": 100 }, "maxRedirects": { "title": "Maximum redirects per URL", "minimum": 0, "maximum": 20, "type": "integer", "description": "Fails a URL if it redirects more than this many times.", "default": 10 }, "requestTimeoutSecs": { "title": "Request timeout in seconds", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each URL before recording a timeout error.", "default": 20 }, "includePageTitle": { "title": "Extract page title", "type": "boolean", "description": "Fetch and parse the final HTML page title when available.", "default": true } } }, "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 } } } } } } } } } } ```