Platform Integrations¶

AMP publishes content through Metricool, which supports multiple social platforms. This guide covers setup and configuration.

Supported Platforms¶

Metricool Setup¶

1. Create Metricool Account¶

Sign up at metricool.com if you don't have an account.

2. Connect Social Platforms¶

In Metricool: 1. Go to Settings → Social Networks 2. Connect each platform you want to use 3. Authorize AMP to post on your behalf

3. Get API Credentials¶

In Metricool: 1. Go to Settings → API 2. Generate an API token 3. Note your Blog ID (found in URL when viewing your brand)

4. Connect to AMP¶

curl -X POST https://api.amp.dev/v1/connect/metricool \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_metricool_api_token",
    "blog_id": "your_blog_id"
  }'

5. Verify Connection¶

curl https://api.amp.dev/v1/connect/status \
  -H "Authorization: Bearer $AMP_API_KEY"

Platform-Specific Configuration¶

Twitter/X¶

Character limits: - Single tweet: 280 characters - Thread tweets: 280 each

Media support: - Images: Up to 4 - GIFs: 1 - Video: Up to 2:20

Best practices:

{
  "constraints": {
    "twitter": {
      "use_threads_for_long_content": true,
      "max_hashtags": 3,
      "include_thread_numbering": true
    }
  }
}

LinkedIn¶

Character limits: - Posts: 3,000 characters - Articles: Unlimited

Media support: - Images: Up to 9 - Video: Up to 10 minutes - Documents: PDF, PPT

Best practices:

{
  "constraints": {
    "linkedin": {
      "prefer_long_form": true,
      "max_hashtags": 5,
      "professional_tone": true
    }
  }
}

Instagram¶

Character limits: - Caption: 2,200 characters

Media requirements: - Square: 1080x1080 - Portrait: 1080x1350 - Landscape: 1080x566 - Stories: 1080x1920

Best practices:

{
  "constraints": {
    "instagram": {
      "hashtags_in_first_comment": true,
      "max_hashtags": 25,
      "require_visual": true
    }
  }
}

Facebook¶

Character limits: - Posts: 63,206 characters (but shorter is better)

Best practices:

{
  "constraints": {
    "facebook": {
      "optimal_length": 40-80,
      "include_visual": true
    }
  }
}

Multi-Platform Publishing¶

Cross-Posting¶

Publish same content to multiple platforms with automatic adaptation:

{
  "platforms": ["twitter", "linkedin", "instagram"],
  "constraints": {
    "cross_platform_adaptation": true
  }
}

AMP automatically: - Adjusts copy length - Reformats hashtags - Adapts visual dimensions - Matches platform tone

Platform-Specific Content¶

Generate unique content per platform:

{
  "platforms": ["twitter", "linkedin"],
  "constraints": {
    "unique_content_per_platform": true
  }
}

Scheduling Considerations¶

Time Zones¶

Content is scheduled in the specified timezone:

{
  "constraints": {
    "timezone": "America/New_York",
    "posting_times": ["09:00", "14:00"]
  }
}

Optimal Times by Platform¶

Enable automatic optimization:

{
  "constraints": {
    "use_optimal_times": true
  }
}

Analytics Integration¶

Available Metrics¶

Metricool provides: - Impressions - Engagements (likes, comments, shares) - Reach - Link clicks - Follower growth - Video views

Sync Frequency¶

Analytics sync automatically: - First 24 hours: Every hour - Days 2-7: Every 6 hours - After 7 days: Daily

Manual Sync¶

curl -X POST https://api.amp.dev/v1/analytics/sync \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -d '{
    "platform": "twitter",
    "content_ids": ["cnt_xxx"]
  }'

Troubleshooting¶

"Platform not connected"¶

Cause: Platform disconnected in Metricool

Fix: 1. Log into Metricool 2. Reconnect the platform 3. Test connection in AMP

"Publishing failed"¶

Cause: Various (rate limits, content policy, auth expired)

Fix: 1. Check error details in publishing log 2. Verify content meets platform guidelines 3. Check Metricool connection status

"Media upload failed"¶

Cause: File size or format issues

Fix: - Ensure images are under 5MB - Use supported formats (JPG, PNG, GIF) - Check dimensions match platform requirements

Analytics not updating¶

Cause: API rate limits or sync delay

Fix: 1. Wait for next sync cycle 2. Manually trigger sync 3. Check Metricool API status

Security¶

Token Management¶

• Metricool tokens are encrypted at rest
• Tokens are never exposed in API responses
• Rotate tokens periodically

Permissions¶

AMP only requests permissions needed for: - Posting content - Reading analytics - Managing scheduled posts

Disconnecting¶

Remove integration immediately:

curl -X DELETE https://api.amp.dev/v1/connect/metricool \
  -H "Authorization: Bearer $AMP_API_KEY"

This: - Cancels all scheduled posts - Removes stored credentials - Preserves historical data