# Hook Forge - 20 Scored TikTok Ad Hooks (`gbcxrp/hook-forge`) Actor Product in, 20 platform-native ad hooks out - scored, ranked, compliance-checked across 10 proven frameworks. Free. Built by a working UGC ad studio. - **URL**: https://apify.com/gbcxrp/hook-forge.md - **Developed by:** [Greg Comer](https://apify.com/gbcxrp) (community) - **Categories:** AI, Social media, Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Hook Forge — 20 Scored TikTok Ad Hooks **Give it a product. Get back up to 20 scroll-stopping ad hooks — scored, ranked, and compliance-checked — in seconds.** The first 1–3 seconds decide whether your short-form ad lives or dies. Hook Forge generates hooks across **10 proven frameworks** used by working UGC ad studios: Problem-Agitate · POV · Discovery · Before/After · Three Things · Unboxing Beat · Stat Shock · Objection Flip · Comparison · Gift Angle ### What you get - Up to **20 hooks** (≤12 words each), spread across all 10 frameworks - A **predicted scroll-stop score (1–10)** for every hook, with the reason - **Top 3 picks** with framework diversity (never two of the same style) - Price-anchored variants when you include the price in the product field - Gift-angle variants when you name an audience ### Compliance, built in - **No fabricated statistics** — percentage claims are auto-rejected - **No fake urgency** — scarcity hooks unlock only when you supply a real deal - **No fake-buyer framing** — presenter voice only, FTC-friendly - Anything that trips a rule lands in `banned_flags` with the reason, never in your hook list ### Input example ```json { "product": "16-color galaxy projector lamp, $9.49", "audience": "teens and parents", "platform": "tiktok", "n": 20 } ```` ### Output example (one hook) ```json { "framework": "POV", "text": "POV: the galaxy projector lamp just changed the whole room.", "angle": "curiosity", "predicted_scroll_stop_score": 9, "score_reason": "open loop + concrete visual implied + native tone" } ``` ### Who made this Built by a working AI UGC ad studio that produces TikTok Shop video ads daily. These are the exact frameworks we script from. **Want the hooks turned into finished vertical video ads (48h turnaround)?** Find us on Fiverr: search seller **gbcxrp** — "AI UGC video ads for your TikTok Shop product." # Actor input Schema ## `product` (type: `string`): Product name + one-line what-it-is. Paste the listing title. Include the price (e.g. $9.49) to unlock price-anchored hooks. ## `audience` (type: `string`): Who the ad targets, e.g. 'new parents', 'teens', 'women 45+'. Used for gift-angle hooks. ## `platform` (type: `string`): Which platform the hooks should feel native to. ## `n` (type: `integer`): 1-20 ## `dealText` (type: `string`): ONLY if a real discount exists (e.g. '20% off this week'). Urgency hooks stay locked unless this is filled — no fake scarcity, ever. ## Actor input object example ```json { "product": "16-color galaxy projector lamp, $9.49", "platform": "tiktok", "n": 20 } ``` # 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 = { "product": "16-color galaxy projector lamp, $9.49" }; // Run the Actor and wait for it to finish const run = await client.actor("gbcxrp/hook-forge").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 = { "product": "16-color galaxy projector lamp, $9.49" } # Run the Actor and wait for it to finish run = client.actor("gbcxrp/hook-forge").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 '{ "product": "16-color galaxy projector lamp, $9.49" }' | apify call gbcxrp/hook-forge --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gbcxrp/hook-forge", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Hook Forge - 20 Scored TikTok Ad Hooks", "description": "Product in, 20 platform-native ad hooks out - scored, ranked, compliance-checked across 10 proven frameworks. Free. Built by a working UGC ad studio.", "version": "0.0", "x-build-id": "I5s9xVy5FgdKz3eB0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gbcxrp~hook-forge/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gbcxrp-hook-forge", "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/gbcxrp~hook-forge/runs": { "post": { "operationId": "runs-sync-gbcxrp-hook-forge", "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/gbcxrp~hook-forge/run-sync": { "post": { "operationId": "run-sync-gbcxrp-hook-forge", "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": [ "product" ], "properties": { "product": { "title": "Product", "type": "string", "description": "Product name + one-line what-it-is. Paste the listing title. Include the price (e.g. $9.49) to unlock price-anchored hooks." }, "audience": { "title": "Audience (optional)", "type": "string", "description": "Who the ad targets, e.g. 'new parents', 'teens', 'women 45+'. Used for gift-angle hooks." }, "platform": { "title": "Platform", "enum": [ "tiktok", "reels", "shorts" ], "type": "string", "description": "Which platform the hooks should feel native to.", "default": "tiktok" }, "n": { "title": "How many hooks", "minimum": 1, "maximum": 20, "type": "integer", "description": "1-20", "default": 20 }, "dealText": { "title": "Real deal (optional)", "type": "string", "description": "ONLY if a real discount exists (e.g. '20% off this week'). Urgency hooks stay locked unless this is filled — no fake scarcity, ever." } } }, "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 } } } } } } } } } } ```