What does Promote Apify Actors do?

Promote Apify Actors automatically gathers all your Apify actors and emails them in beautifully formatted cards. This eliminates manual work and makes it effortless to promote your automation projects and share your work with colleagues, clients, or the broader community.

The actor collects:

• Actor names and descriptions
• Actor URLs

Features

• Personalized greeting and sender name
• Responsive HTML invitation card with header image
• List of your public Apify actors included automatically
• Plain-text fallback for email clients
• Optional Apify affiliate referral link (?fpr= parameter)
• Test mode: preview full email content without sending
• Built-in unsubscribe support (domain tracking technology)
• Full email HTML/text saved to dataset for easy preview
• Detailed status, error logging, and message tracking

Why use Promote Apify Actors?

If you've built multiple Apify actors, managing and promoting them can be time-consuming. Promote Apify Actors streamlines the process by automatically organizing all your actors into shareable, professionally formatted cards.

Here are just some of the ways you could use this actor:

• Share your actor portfolio with potential clients or collaborators
• Promote your automation solutions to team members or stakeholders
• Create regular updates about your latest actor releases
• Maintain an organized repository of all your projects for easy reference
• Showcase your work across different communication channels

How to use Promote Apify Actors

It's easy to gather and share all your Apify actors with Promote Apify Actors. Just follow these few steps:

1. Click on Try for free on the actor page.
2. Configure your email settings and preferences.
3. Click on Run.
4. When the actor has finished, your beautifully formatted actor cards will be sent to your email address.
5. After the run:
   • Check the Dataset tab for full results (see below)
   • Emails are sent only when testMode is false

Input Fields

{
  "fields": [
    {
      "name": "testMode",
      "type": "boolean",
      "required": false,
      "default": true,
      "description": "Preview mode — generates card & saves full content to dataset, but does not send email"
    },
    {
      "name": "senderName",
      "type": "string",
      "required": true,
      "default": "John from Apify",
      "description": "Your name as shown in the email and on the card"
    },
    {
      "name": "recipientEmail",
      "type": "string",
      "required": true,
      "default": "test@example.com",
      "description": "Email address to receive the invitation"
    },
    {
      "name": "message",
      "type": "string",
      "required": true,
      "default": "Join me on Apify — it's awesome!",
      "description": "Personal greeting text that appears on the card"
    },
    {
      "name": "referralCode",
      "type": "string",
      "required": false,
      "default": "",
      "description": "Your Apify affiliate code (added to signup link if provided)"
    },
    {
      "name": "senderEmail",
      "type": "string",
      "required": false,
      "default": "",
      "description": "Your real email address (optional) — sets Reply-To so replies go to you, and shows in footer for clarity. Leave blank to keep private."
    },
    {
      "name": "apifyApiToken",
      "type": "string",
      "required": true,
      "default": "",
      "description": "The API token of the user running the Actor — used to fetch your public Apify actors"
    }
  ]
}

Output & Dataset

Every run creates one record in the default dataset (even in test mode). Full email content is always saved — perfect for previewing the invitation card.

Dataset Fields

{
  "fields": [
    {
      "name": "status",
      "type": "string",
      "description": "test_mode / pending / success / failed"
    },
    {
      "name": "recipient",
      "type": "string",
      "description": "The recipient email address"
    },
    {
      "name": "referralUsed",
      "type": "boolean",
      "description": "true if a referral code was used"
    },
    {
      "name": "signupLink",
      "type": "string",
      "description": "Full Apify signup URL (with referral param if provided)"
    },
    {
      "name": "messageId",
      "type": "string",
      "description": "Message ID from successful send (empty in test mode)"
    },
    {
      "name": "htmlPreview",
      "type": "string",
      "description": "Truncated preview of the HTML email body"
    },
    {
      "name": "fullHtml",
      "type": "string",
      "description": "Complete generated HTML email (copy-paste to view the card)"
    },
    {
      "name": "fullText",
      "type": "string",
      "description": "Complete plain-text email fallback"
    },
    {
      "name": "headerImageUrl",
      "type": "string",
      "description": "URL of the header image used in the invitation card"
    },
    {
      "name": "timestamp",
      "type": "string",
      "description": "ISO datetime when the attempt occurred"
    },
    {
      "name": "error",
      "type": "string",
      "description": "Detailed error message (only if status = 'failed')"
    },
    {
      "name": "actorsList",
      "type": "array",
      "description": "Array of public Apify actors fetched for the sender (name, URL, description)"
    }
  ]
}

Quick preview tip:

Copy the value of fullHtml from any dataset item → paste into a new .html file → open in browser to see the exact invitation card including your public actors.

Quick preview tip:

Copy the value of fullHtml from any dataset item → paste into a new .html file → open in browser to see the exact invitation card.

🔒 Per-User Daily Sending Limit ⚡

To prevent abuse and ensure fair usage, this actor enforces a per-user daily sending cap:

• Each Apify user can send a maximum of 10 invitation emails per day.
• The limit is enforced automatically per Apify account.
• Counters reset daily (UTC).
• Only successful email sends count toward the limit.
• testMode runs do not affect the daily limit.
• If a user exceeds the limit, the actor stops execution and shows an error.

This ensures email deliverability, protects sender reputation, and prevents misuse.

Important Notes

• Unsubscribe: Built-in domain tracking technology — recipients see an unsubscribe option (header button + footer link).
• Deliverability: Test to your own Gmail/Yahoo first. Softened wording helps avoid spam folders.
• Privacy: Only the recipient email and your message are used — no data stored beyond the run's dataset.
• Replies: If you provide senderEmail, replies go directly to you. The footer shows your name + email (clickable mailto link) for transparency.

How much will it cost to use Promote Apify Actors?

Apify gives you $5 free usage credits every month on the Apify Free plan. This actor uses minimal computational resources, so running it multiple times per month will easily fit within your free credits.

If you need to run this actor frequently or with additional features, check out Apify subscription plans to find the option that works best for you.

Tips for using Promote Apify Actors

• Run the actor regularly to keep your team updated on the latest actors you've created
• Customize the email template to match your branding
• Use this as part of your portfolio or case study materials
• Schedule regular runs to maintain an up-to-date promotional repository

Is it legal to use Go Viral: Apify Actors?

This actor gathers data from your own Apify account, so there are no legal concerns regarding data collection or privacy. You have full ownership of your actor information and can share it freely.

For more information about data privacy and web scraping legality, we recommend reading our blog post: is web scraping legal?.