personalize.marketing
GuidesCode

cURL Integration

How to use the personalize.marketing API with cURL

cURL Integration

Increase Timeout to 5 Minutes

The API analyzes influencer profiles in real-time, which can take up to 300 seconds per request. Set your HTTP client timeout to at least 300 seconds (5 minutes) to avoid premature timeouts.

Prerequisites

You need an API key. See Get Started for instructions.

Security Tip

Store your API key in environment variables to avoid accidentally committing it to git. Never hardcode API keys in your source code.

Example

# ============ CONFIGURE THESE ============
export PERSONALIZE_API_KEY="your_api_key_here"
PROFILE_URL="https://linkedin.com/in/arnold-schwarzenegger/"
TEMPLATE="Hey {{first name}},

Love what you are building with {{their company or product}}. We make fitness supplements that would pair perfectly with your brand.

Worth a quick chat?"
BRAND_CONTEXT="We are a fitness supplement brand targeting health-conscious entrepreneurs"
AI_INSTRUCTIONS="Keep the tone professional but friendly"
# =========================================

curl -X POST https://personalize.marketing/api/v1/personalize-api \
  --max-time 300 \
  -H "Authorization: Bearer $PERSONALIZE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"profile_url\": \"$PROFILE_URL\",
    \"template\": \"$(echo "$TEMPLATE" | sed ':a;N;$!ba;s/\n/\\n/g')\",
    \"brand_context\": \"$BRAND_CONTEXT\",
    \"ai_instructions\": \"$AI_INSTRUCTIONS\",
    \"enable_brand_fit_score\": false,
    \"include_profile_report\": false,
    \"include_raw_data\": false
  }"

Response:

{
  "success": true,
  "personalized_text": "Hey Arnold,\n\nLove what you are building with The Pump app. We make fitness supplements that would pair perfectly with your brand.\n\nWorth a quick chat?",
  "profile_url": "https://linkedin.com/in/arnold-schwarzenegger/",
  "brand_fit_score": 9,
  "profile_report": "Arnold Schwarzenegger is an entrepreneur, actor, and fitness icon with 500K+ LinkedIn followers. He actively promotes his businesses including The Pump app and his daily newsletter. His content focuses on fitness, motivation, and health advice. High engagement rates with a professional, health-conscious audience.",
  "raw_data": {
    "profile": {
      "firstName": "Arnold",
      "lastName": "Schwarzenegger",
      "headline": "Businessman | Founder of The Pump",
      "followerCount": 500000
    },
    "posts": ["..."]
  }
}

Request Fields

FieldRequiredDescription
profile_urlYesLinkedIn, Instagram, or TikTok profile URL
templateYesYour message with {{instruction}} placeholders (e.g., {{first name}})
ai_instructionsNoCustom tone/style instructions for the AI
brand_contextNoYour brand description for better post matching
enable_variationsNoRephrase output to avoid spam detection
enable_brand_fit_scoreNoGet 1-10 brand fit score
include_profile_reportNoGet detailed influencer analysis
include_raw_dataNoGet raw profile data (unstable, for debugging only)

See API Reference for complete documentation.

On this page