# Unofficial Google URL Shortener (`dev00/unofficial-google-url-shortener`) Actor Generate official share.google short links for any URL. Features ultra-high domain authority, bypasses spam filters, and provides alternative Google sub-domain routing. - **URL**: https://apify.com/dev00/unofficial-google-url-shortener.md - **Developed by:** [dev00](https://apify.com/dev00) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $10.00 / 1,000 unofficial google url shorteners 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 ## 🔗 Unofficial Google URL Shortener (share.google & www.google.com) Generate official Google shortened links instantly. The retirement of `goo.gl` made creating official Google short links impossible for the public. This Actor utilizes a secure, internal Google Search API gateway to generate official `share.google` short links for any URL. Because these short links are hosted on Google's core domains, they possess maximum domain authority. This makes them virtually immune to SMS carrier blocking and email spam filters, drastically outperforming standard `bit.ly` or `tinyurl` links. --- ### 🌟 Key Features * **Maximum Trust & Authority**: Shortened links are hosted on `share.google` and `www.google.com`, ensuring maximum user trust and high click-through rates. * **Immunity to Spam Filters**: Perfect for cold-email outreach, SMS text marketing campaigns, and social media links where third-party link shorteners are blacklisted. * **Dual-Routing Formats**: For every URL shortened, the API returns the standard short link AND an alternative search-routed link (`https://www.google.com/share.google?q={id}`). * **Lightweight & High-Performance**: Operates at edge speeds with latency measured in milliseconds. * **CORS-Enabled & Secure**: Secured via custom `X-Api-Key` headers for seamless application programming. * **Health Monitoring**: Includes `/health` status endpoints for seamless integration into uptime monitors. --- ### 🛠️ How It Works This Actor forwards your target long URL to a secure Cloudflare Worker edge reverse-proxy. The proxy constructs the internal Google search API payload, performs an authenticated fetch to Google's search service (`GetShortenedKpSharingUrl`), strips Google's anti-hijacking JSON prefix (`)]}'\n`), and extracts the unique short code ID. --- ### 📥 Input Parameters | Field | Type | Description | Prefill Example | | :--- | :--- | :--- | :--- | | **Target Long URL** | `string` | The target long URL to shorten. Must start with http:// or https:// | `https://google.com` | #### Input JSON Example ```json { "url": "https://google.com" } ```` *** ### 📤 Output Data Structure Tabular datasets output clean rows mapping the shortened status: #### Output JSON Example ```json { "success": true, "original_url": "https://google.com", "shortened_url": "https://share.google/L5FVgIBfBwprSEq9u", "alternative_url": "https://www.google.com/share.google?q=L5FVgIBfBwprSEq9u", "id": "L5FVgIBfBwprSEq9u", "description": "Successfully shortened URL via official Google APIs." } ``` *** ### 💳 Monetization & Cost This Actor utilizes the **Pay-Per-Event (PPE)** pricing model on the Apify Store: - **Base Pricing**: Only **$10.00 per 1,000 successful lookups** (`$0.01` per event). - **Pay as You Go**: If validation fails due to network/gateway issues, no billing charges occur. # Actor input Schema ## `url` (type: `string`): Provide the target long URL to shorten (e.g., 'https://google.com'). Must start with http:// or https:// ## Actor input object example ```json { "url": "https://google.com" } ``` # Actor output Schema ## `results` (type: `string`): No description ## `keyValueStoreResult` (type: `string`): No description # 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 = { "url": "https://google.com" }; // Run the Actor and wait for it to finish const run = await client.actor("dev00/unofficial-google-url-shortener").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 = { "url": "https://google.com" } # Run the Actor and wait for it to finish run = client.actor("dev00/unofficial-google-url-shortener").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 '{ "url": "https://google.com" }' | apify call dev00/unofficial-google-url-shortener --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dev00/unofficial-google-url-shortener", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Unofficial Google URL Shortener", "description": "Generate official share.google short links for any URL. Features ultra-high domain authority, bypasses spam filters, and provides alternative Google sub-domain routing.", "version": "1.0", "x-build-id": "fFSQ8YmBvGeNVDzsD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dev00~unofficial-google-url-shortener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dev00-unofficial-google-url-shortener", "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/dev00~unofficial-google-url-shortener/runs": { "post": { "operationId": "runs-sync-dev00-unofficial-google-url-shortener", "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/dev00~unofficial-google-url-shortener/run-sync": { "post": { "operationId": "run-sync-dev00-unofficial-google-url-shortener", "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": [ "url" ], "properties": { "url": { "title": "Target Long URL", "type": "string", "description": "Provide the target long URL to shorten (e.g., 'https://google.com'). Must start with http:// or https://" } } }, "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 } } } } } } } } } } ```