# AI Social Media Content Generator (`listenllc/social-content-generator`) Actor Stop staring at a blank screen. Generate a full week of social media posts in 60 seconds — LinkedIn, X, Instagram, Pinterest. $0.10/post. No subscription. - **URL**: https://apify.com/listenllc/social-content-generator.md - **Developed by:** [Wiz](https://apify.com/listenllc) (community) - **Categories:** AI, Social media - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $100.00 / 1,000 content generateds 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 ## AI Social Media Content Generator > Generate a full week of ready-to-publish social media content in under 60 seconds. No copywriting skills required. Stop staring at a blank screen. This Actor takes your topic, brand voice, and target audience — then generates platform-optimized posts for **LinkedIn, X/Twitter, Instagram, and Pinterest** using AI (Claude or GPT, your choice). Every post is formatted for its platform, includes hashtags, and is ready to copy-paste and publish. No editing needed. --- ### What you get **For each post generated, you receive:** - Full post text, formatted for the specific platform - Relevant hashtags (platform-appropriate count) - Content style label (educational, storytelling, listicle, etc.) - Hook / opening line extracted separately for easy preview - Engagement estimate (low / medium / high) - Best time to post suggestion - Character count with limit validation **Supported platforms:** | Platform | Format | Hashtags | Max Length | |---|---|---|---| | LinkedIn | Professional long-form with hooks | 5 | 3,000 chars | | X / Twitter | Punchy, concise, thread-ready | 2 | 280 chars | | Instagram | Conversational with emoji formatting | 15 | 2,200 chars | | Pinterest | SEO-rich pin descriptions | 5 | 500 chars | --- ### Pricing **$0.10 per post generated** — that is it. No monthly fees, no subscriptions, no hidden charges. | What you need | Posts | Cost | |---|---|---| | Quick test | 5 posts, 1 platform | $0.50 | | One week of content | 5 posts × 4 platforms | $2.00 | | Monthly content batch | 30 posts × 4 platforms | $12.00 | | Agency (10 clients) | 20 posts × 4 platforms × 10 | $80.00 | Compare that to hiring a freelance copywriter ($50–150 per post) or spending 30+ minutes writing each post yourself. --- ### How to use it #### Step 1: Enter your topic Be specific. Instead of "marketing", try "B2B content marketing strategies for SaaS startups with limited budgets." #### Step 2: Configure your settings - **Pick your platforms** — LinkedIn, X, Instagram, Pinterest, or all four - **Set your brand voice** — "professional but approachable" or "bold and provocative" or anything in between - **Choose content style** — educational tips, storytelling, listicles, hot takes, how-tos, or a mix - **Select your AI** — Claude (Anthropic) or GPT (OpenAI) — bring your own API key #### Step 3: Hit Start The Actor generates your content in under 60 seconds. Each post lands in your dataset, ready to export as JSON, CSV, or Excel. #### Step 4: Publish Copy-paste directly to your platforms. Every post is formatted and ready to go. --- ### Input examples #### Quick start — LinkedIn thought leadership ```json { "topic": "Why most B2B companies fail at content marketing", "platforms": ["linkedin"], "postsPerPlatform": 7, "brandVoice": "bold and contrarian, backed by experience", "targetAudience": "B2B marketing leaders and CMOs", "contentStyle": "mixed", "aiProvider": "anthropic", "anthropicApiKey": "YOUR_KEY" } ```` #### Full week across all platforms ```json { "topic": "productivity systems for entrepreneurs who hate productivity advice", "platforms": ["linkedin", "twitter", "instagram", "pinterest"], "postsPerPlatform": 5, "brandVoice": "witty and real, anti-hustle-culture", "targetAudience": "solo founders and freelancers", "contentStyle": "mixed", "includeHashtags": true, "includeCallToAction": true, "aiProvider": "openai", "openaiApiKey": "YOUR_KEY" } ``` #### Instagram-only content batch ```json { "topic": "plant-based meal prep for busy parents", "platforms": ["instagram"], "postsPerPlatform": 14, "brandVoice": "warm, encouraging, zero judgment", "targetAudience": "millennial parents interested in healthy eating", "contentStyle": "how_to", "includeHashtags": true, "language": "en", "aiProvider": "anthropic", "anthropicApiKey": "YOUR_KEY" } ``` *** ### Output format Each generated post includes: ```json { "platform": "LinkedIn", "platform_key": "linkedin", "content": "The full post text ready to publish...", "hashtags": ["leadership", "B2B", "marketing", "growth", "strategy"], "style": "controversial_take", "hook": "Most B2B content fails because it is written for algorithms, not humans.", "estimated_engagement": "high", "best_time_to_post": "Tuesday 8am EST", "content_type": "hot_take", "post_number": 1, "topic": "Why most B2B companies fail at content marketing", "ai_provider": "Claude (Anthropic)", "generated_at": "2026-03-28T14:30:00Z", "character_count": 1847, "max_characters": 3000, "within_limit": true } ``` *** ### Who this is for - **Solo founders** who need consistent social media presence but do not have time to write - **Social media managers** handling multiple client accounts - **Marketing agencies** producing content at scale - **Coaches and consultants** building thought leadership - **E-commerce brands** maintaining active social channels - **Content creators** who want to batch-produce posts weekly *** ### Content styles available | Style | Best for | Description | |---|---|---| | Educational | LinkedIn, Pinterest | Teaches something specific. Data-backed tips. | | Storytelling | LinkedIn, Instagram | Personal anecdotes that lead to insights. | | Listicle | All platforms | Numbered tips or bullet-point insights. | | Motivational | Instagram, LinkedIn | Inspirational content that drives action. | | Hot Take | Twitter, LinkedIn | Bold opinions that spark debate. | | How-To | Pinterest, Instagram | Step-by-step practical guides. | | Behind the Scenes | Instagram, LinkedIn | Authentic, vulnerable, real content. | | Mixed | All platforms | Variety pack — the Actor rotates styles. | *** ### Supported languages English, Spanish, Portuguese (Brazil), German, French, Italian, Dutch, Polish, Japanese, Korean. *** ### API key setup This Actor requires your own AI provider API key. Your key is encrypted and never stored. **For Claude (Anthropic):** 1. Go to [console.anthropic.com](https://console.anthropic.com/) 2. Create an account and add credits 3. Generate an API key 4. Paste it in the "Anthropic API Key" field **For GPT (OpenAI):** 1. Go to [platform.openai.com](https://platform.openai.com/) 2. Create an account and add credits 3. Generate an API key 4. Paste it in the "OpenAI API Key" field *** ### FAQ **How much does each post cost in AI API fees?** Roughly $0.005–0.02 per post depending on length and provider. A batch of 20 posts typically costs under $0.30 in API fees on top of the Actor's per-post charge. **Can I schedule posts directly from this Actor?** This Actor generates content only. For scheduling, export your posts and use Buffer, Hootsuite, or connect via Zapier/Make. **What if a post exceeds the platform character limit?** Each post includes a `within_limit` flag. The AI is prompted to stay within limits, but if a post runs over, you will see it flagged in the output. **Can I run this on a schedule?** Yes. Set up an Apify schedule to generate fresh content weekly or daily. Combine with webhooks to send results to Slack, email, or Google Sheets automatically. **Do you store my API keys?** No. API keys are marked as secrets in the input schema and are encrypted by Apify. They are used only during the Actor run and are never logged or stored. *** ### Integrations Export your generated content to: - **Google Sheets** — via Apify's native integration - **Zapier / Make** — trigger workflows when content is generated - **Slack** — get notified with your new content batch - **Airtable** — build a content calendar automatically - **CSV / JSON / Excel** — download directly from the dataset *** ### Changelog - **1.0.0** (2026-03-28) — Initial release: 4 platforms, 8 content styles, 10 languages, Claude + GPT support *** Built by [Listen LLC](https://www.ListenTechnology.ai) — AI-powered content and behavioral technology. # Actor input Schema ## `topic` (type: `string`): What should the content be about? Be specific for better results. Example: 'productivity tips for remote workers' or 'sustainable fashion trends 2026' ## `platforms` (type: `array`): Select which platforms to generate content for. Each platform gets optimized formatting. ## `postsPerPlatform` (type: `integer`): How many posts to generate for each selected platform. ## `brandVoice` (type: `string`): Describe the tone and style you want. Examples: 'professional but approachable', 'bold and provocative', 'warm and educational', 'witty and casual' ## `targetAudience` (type: `string`): Who is this content for? The more specific, the better the content. Example: 'B2B SaaS founders', 'millennial parents', 'fitness enthusiasts over 40' ## `includeHashtags` (type: `boolean`): Generate relevant hashtags for each post (recommended for Instagram and Twitter). ## `includeCallToAction` (type: `boolean`): Add a call-to-action at the end of each post (e.g., 'Follow for more', 'Save this post', 'Drop a comment'). ## `contentStyle` (type: `string`): What type of content do you want? ## `language` (type: `string`): Language for the generated content. ## `aiProvider` (type: `string`): Choose which AI model powers your content generation. ## `anthropicApiKey` (type: `string`): Your Anthropic API key. Get one at https://console.anthropic.com/. Required if using Claude. ## `openaiApiKey` (type: `string`): Your OpenAI API key. Get one at https://platform.openai.com/. Required if using GPT. ## Actor input object example ```json { "topic": "5 productivity tips for remote workers who struggle with focus", "platforms": [ "linkedin", "twitter", "instagram" ], "postsPerPlatform": 5, "brandVoice": "professional but approachable, with occasional humor", "targetAudience": "busy professionals and entrepreneurs", "includeHashtags": true, "includeCallToAction": true, "contentStyle": "mixed", "language": "en", "aiProvider": "anthropic" } ``` # Actor output Schema ## `results` (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 = { "topic": "5 productivity tips for remote workers who struggle with focus", "platforms": [ "linkedin", "twitter", "instagram" ], "postsPerPlatform": 5, "brandVoice": "professional but approachable, with occasional humor", "targetAudience": "busy professionals and entrepreneurs", "contentStyle": "mixed", "language": "en" }; // Run the Actor and wait for it to finish const run = await client.actor("listenllc/social-content-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 = { "topic": "5 productivity tips for remote workers who struggle with focus", "platforms": [ "linkedin", "twitter", "instagram", ], "postsPerPlatform": 5, "brandVoice": "professional but approachable, with occasional humor", "targetAudience": "busy professionals and entrepreneurs", "contentStyle": "mixed", "language": "en", } # Run the Actor and wait for it to finish run = client.actor("listenllc/social-content-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 '{ "topic": "5 productivity tips for remote workers who struggle with focus", "platforms": [ "linkedin", "twitter", "instagram" ], "postsPerPlatform": 5, "brandVoice": "professional but approachable, with occasional humor", "targetAudience": "busy professionals and entrepreneurs", "contentStyle": "mixed", "language": "en" }' | apify call listenllc/social-content-generator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=listenllc/social-content-generator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AI Social Media Content Generator", "description": "Stop staring at a blank screen. Generate a full week of social media posts in 60 seconds — LinkedIn, X, Instagram, Pinterest. $0.10/post. No subscription.", "version": "1.0", "x-build-id": "QK7fK3LN196QNXCIN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/listenllc~social-content-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-listenllc-social-content-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/listenllc~social-content-generator/runs": { "post": { "operationId": "runs-sync-listenllc-social-content-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/listenllc~social-content-generator/run-sync": { "post": { "operationId": "run-sync-listenllc-social-content-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": [ "topic" ], "properties": { "topic": { "title": "Topic or Niche", "type": "string", "description": "What should the content be about? Be specific for better results. Example: 'productivity tips for remote workers' or 'sustainable fashion trends 2026'" }, "platforms": { "title": "Target Platforms", "type": "array", "description": "Select which platforms to generate content for. Each platform gets optimized formatting.", "items": { "type": "string", "enum": [ "linkedin", "twitter", "instagram", "pinterest" ] }, "default": [ "linkedin", "twitter", "instagram" ] }, "postsPerPlatform": { "title": "Posts Per Platform", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many posts to generate for each selected platform.", "default": 5 }, "brandVoice": { "title": "Brand Voice / Tone", "type": "string", "description": "Describe the tone and style you want. Examples: 'professional but approachable', 'bold and provocative', 'warm and educational', 'witty and casual'", "default": "professional and engaging" }, "targetAudience": { "title": "Target Audience", "type": "string", "description": "Who is this content for? The more specific, the better the content. Example: 'B2B SaaS founders', 'millennial parents', 'fitness enthusiasts over 40'", "default": "" }, "includeHashtags": { "title": "Include Hashtags", "type": "boolean", "description": "Generate relevant hashtags for each post (recommended for Instagram and Twitter).", "default": true }, "includeCallToAction": { "title": "Include Call-to-Action", "type": "boolean", "description": "Add a call-to-action at the end of each post (e.g., 'Follow for more', 'Save this post', 'Drop a comment').", "default": true }, "contentStyle": { "title": "Content Style", "enum": [ "educational", "storytelling", "listicle", "motivational", "controversial_take", "how_to", "behind_the_scenes", "mixed" ], "type": "string", "description": "What type of content do you want?", "default": "mixed" }, "language": { "title": "Language", "enum": [ "en", "es", "pt-BR", "de", "fr", "it", "nl", "pl", "ja", "ko" ], "type": "string", "description": "Language for the generated content.", "default": "en" }, "aiProvider": { "title": "AI Provider", "enum": [ "anthropic", "openai" ], "type": "string", "description": "Choose which AI model powers your content generation.", "default": "anthropic" }, "anthropicApiKey": { "title": "Anthropic API Key", "type": "string", "description": "Your Anthropic API key. Get one at https://console.anthropic.com/. Required if using Claude." }, "openaiApiKey": { "title": "OpenAI API Key", "type": "string", "description": "Your OpenAI API key. Get one at https://platform.openai.com/. Required if using GPT." } } }, "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 } } } } } } } } } } ```