Customer Psychology Map Actor

Overview

This actor automates the creation of a detailed customer psychology map from a simple demographic description. It uses an AI-powered framework to analyze a target market and generate insights into motivations, fears, desires, and behaviors. It's designed for developers and teams needing rapid, structured market analysis without traditional research costs.

Key Features

• AI-Powered Analysis: Processes input using a research-backed framework of 30 psychology questions.
• Structured Output: Returns a comprehensive psychology map with 5 actionable insights for each question.
• Fast Results: Generates a complete analysis in minutes.
• Dual-Format Export: Provides data in both JSON for programmatic use and a formatted Markdown report for human readability.
• Cost-Effective: Priced per request at a fraction of traditional market research.

How to Use

The actor is straightforward to integrate via its API.

1. Provide Input: Send a POST request with a JSON payload containing a targetMarket string (1-2 descriptive sentences).
2. Trigger Processing: The actor runs the AI analysis using its psychology question framework.
3. Receive Output: Get the completed psychology map in the response, available in JSON and Markdown formats.

Example API Call

curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"targetMarket": "Amateur pickleball players aged 35-55 who play 2-3 times per week at local community centers."}'

Input/Output

Input:
The required input is a concise description of your target demographic.

{
  "targetMarket": "Your specific target customer description here."
}

Output:
The response is a JSON object containing the full analysis.

{
  "success": true,
  "data": {
    "shortened_name": "Amateur Pickleball Players",
    "psychology_map": {
      "questions_and_answers": [
        {
          "question": "What problems exist in the life of amateur pickleball players?",
          "answers": [
            "Decision fatigue in paddle choices",
            "Finding players without advanced scheduling"
          ]
        }
        // ... 29 more Q&A pairs
      ]
    },
    "markdown": "# Customer Psychology Map: Amateur Pickleball Players...",
    "generated_at": "2025-01-22T10:30:00Z"
  }
}

Primary Use Cases:
* Marketing & Agencies: Generating detailed buyer personas for ad copy, social content, and client campaigns.
* Product Development: Identifying user pain points and motivations to guide feature prioritization.
* Content Strategy: Creating audience-focused content that resonates emotionally.
* Business Strategy: Quickly analyzing market segments for validation or competitive research.

Find the actor and full details on the Apify platform: https://apify.com/your-actor-page?fpr=python_automation