Ai Color Palette Generator

---

TL;DR

• Input: One text query
• Output: Color palette (hex codes, names) + metadata
• Use it for: Branding, UI/UX, marketing, automation
• Result time: Usually under 20 seconds

---

Table of contents

• Try it now
• Overview
• Usage examples
• Features
• Configuration
• Usage
• Output
• For bloggers & tutorial writers
• Grow your user base
• Integration
• Technical details
• FAQ
• Resources

---

Try it now

Action	Link
Run in Apify Console	Open Actor → Start
API (sync)	POST https://api.apify.com/v2/acts/YOUR_USERNAME~ai-color-palette-generator/run-sync

Replace YOUR_USERNAME with your Apify username.

---

Overview

The AI Color Palette Generator creates color palettes from plain text using the MultipleWords color suggestion API. You describe the theme or style you want, and the Actor returns a curated palette with hex codes, color names, and metadata.

This Actor is useful when you need palettes on demand, at scale, or as part of an automated workflow.

Common use cases

Category	Examples
Design & branding	Brand palettes, marketing materials, cohesive themes
Web development	UI/UX palettes, theme colors, e-commerce sites
Content creation	Graphic design, social media, presentations
Automation	Workflows, batch generation, API integration

Note: Usage rights depend on the upstream API and your Apify plan. Review terms before commercial use.

---

Usage examples

Paste these into the Query field or API input.

Scenario	Query
E-commerce	ecommerce website templates design
Modern UI	modern minimalist website with warm colors
Travel blog	vibrant sunset colors for a travel blog
Corporate	professional corporate blue and gray palette
Cafe / cozy	warm autumn colors for a cafe branding

---

Features

• Text-to-palette generation from a single query
• Clean JSON output for easy integration
• Works in bulk via API
• Input validation and retries with exponential backoff
• Runs fully on Apify (Console, API, automation tools)
• Output schema for organized display in Apify Console

---

Configuration

All settings are provided via the Actor input.

Input parameters

Parameter	Type	Required	Default	Description
query	string	Yes	—	Text description of the color palette theme
nOutputs	integer	No	10	Number of color suggestions (1–10)

Query tips

• Include context (e.g. "website", "mobile app", "branding")
• Mention mood or style (e.g. "modern", "vintage", "minimalist")
• Describe use case (e.g. "ecommerce", "portfolio", "corporate")

Example input

{
  "query": "modern minimalist website design with warm colors",
  "nOutputs": 10
}

---

Usage

Apify Console

1. Open the Actor in Apify Console.
2. Enter a query in the Query field (or use the default).
3. Optionally set Number of Colors (1–10).
4. Click Start and check the Output tab for the color palette and metadata.

API (run-sync)

Replace YOUR_USERNAME with your Apify username and YOUR_API_TOKEN with your Apify API token.

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~ai-color-palette-generator/run-sync?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "vibrant sunset colors for a travel blog", "nOutputs": 10}'

Response includes runId, status, and dataset items with query, colors, and resultsCount.

---

Output

Each run writes one or more items to the default dataset. The Output tab uses the .actor/output_schema.json to show results in organized tables.

Field	Description
query	The text query used for color suggestions
colors	Array of colors: { hex, name }
resultsCount	Number of color suggestions returned
status	Success indicator (1 = success)

Example output (dataset item)

{
  "status": 1,
  "query": "ecommerce website templates design",
  "colors": [
    { "hex": "#3B7A57", "name": "Amazon" },
    { "hex": "#78866B", "name": "CamouflageGreen" }
  ],
  "resultsCount": 10
}

In the Apify Console Output tab you can view Color palettes (overview) or Full dataset (all fields).

---

For bloggers & tutorial writers

You can use this Actor in tutorials, blog posts, or videos without running it first:

• Input: Use the Example input or Usage examples table.
• Output: Use the Example output above to show what users get.
• API: Use the API (run-sync) curl example; remind readers to replace YOUR_USERNAME and YOUR_API_TOKEN.

For promotion ideas, copy-paste posts, and where to share, see PROMOTION.md in this repo.

---

Grow your user base

Promote your Actor to reach more users: share it in relevant communities, forums, and social media where your target audience is active (design, dev, no-code). Consider blog posts, tutorials, or videos that demonstrate use cases.

• PROMOTION.md — Copy-paste posts, where to promote (Apify Discord, Reddit, Twitter/X, LinkedIn, Hacker News), and a 5-action checklist for this week.
• Store visibility — Your .actor/actor.json controls how the Actor appears in the Apify Store: title, description, and readme affect search and conversions. See the actor.json reference for the full definition.

---

Integration

• Make (Integromat) — Use the Apify module and select this Actor; map your query to the Query input.
• Zapier — Use the Apify Zapier app and choose "Run Actor"; select this Actor and pass the query.
• Custom apps — Call the Apify API (/run or /run-sync) with the same input JSON.

---

Technical details

• Runtime: Node.js (see Dockerfile).
• Input: Validated against the input schema; invalid input returns a clear error.
• External API: Uses MultipleWords color suggestion API; failures are retried with exponential backoff.
• Output schema: Defined in .actor/output_schema.json for organized display in Console.

---

FAQ

How long does a run take?
Usually under 20 seconds for a single query.

Can I run multiple queries in one go?
You can run the Actor multiple times (e.g. from a workflow). Each run processes one query; for bulk, use the API or automation tools.

What is the maximum number of colors per palette?
Up to 10 colors per run. Use the nOutputs input (1–10).

Do I need an API key for the color API?
The Actor uses its own integration; you only need your Apify account and (for API calls) your Apify API token.

---

Resources

• Apify Console — Run the Actor and view datasets
• Apify API — Run actors programmatically
• Actor definition (actor.json) — Store visibility: title, description, readme
• Actor output schema — How output is displayed
• PROMOTION.md — How to promote this Actor and grow your user base
• .actor/CHANGELOG.md — Version history