Find when an X account should post

{
  "handle": "elonmusk"
}

curl -X POST "https://crmsolid.com/data-api/v2/tools/best-posting-time" \
  -H "Authorization: Bearer psk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"handle":"elonmusk"}'

const res = await fetch("https://crmsolid.com/data-api/v2/tools/best-posting-time", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CRM_SOLID_DATA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "handle": "elonmusk"
  }),
});

if (!res.ok) {
  const { error } = await res.json();
  throw new Error(`${error.code}: ${error.message} (${error.request_id})`);
}

const { data, meta } = await res.json();

import json
import os

import requests

body = json.loads("""
{
  "handle": "elonmusk"
}
""")

res = requests.post(
    "https://crmsolid.com/data-api/v2/tools/best-posting-time",
    headers={"Authorization": f"Bearer {os.environ['CRM_SOLID_DATA_API_KEY']}"},
    json=body,
    timeout=30,
)
res.raise_for_status()

payload = res.json()
data, meta = payload["data"], payload["meta"]

{
  "data": {
    "profile": {
      "handle": "swyx",
      "twitter_id": "33521530",
      "name": "swyx",
      "avatar_url": "https://pbs.twimg.com/profile_images/1610205747724443648/0DVR0Xnw.jpg",
      "verified": true,
      "followers": 118420,
      "following": 2412,
      "total_posts": 41208,
      "created_at": "2009-04-19T15:02:33.000Z",
      "account_age_days": 6335
    },
    "posts_analyzed": 180,
    "date_range": {
      "from": "2026-05-02T11:20:00.000Z",
      "to": "2026-08-22T18:44:00.000Z"
    },
    "timezone": {
      "estimated": "UTC-8 (US Pacific)",
      "utc_offset": -8
    },
    "heatmap": [
      {
        "day": 2,
        "hour": 9,
        "posts": 14,
        "avg_engagement": 412,
        "avg_likes": 318,
        "avg_retweets": 44,
        "avg_replies": 50,
        "avg_views": 28400,
        "total_engagement": 5768
      }
    ],
    "best_times": [
      {
        "day": 2,
        "day_name": "Tuesday",
        "hour": 9,
        "hour_label": "9:00 AM",
        "avg_engagement": 412,
        "avg_views": 28400,
        "posts": 14
      }
    ],
    "worst_times": [
      {
        "day": 6,
        "day_name": "Saturday",
        "hour": 23,
        "hour_label": "11:00 PM",
        "avg_engagement": 38,
        "avg_views": 2900,
        "posts": 4
      }
    ],
    "best_day": {
      "day": 2,
      "day_name": "Tuesday",
      "posts": 31,
      "avg_engagement": 366,
      "avg_views": 24800,
      "total_engagement": 11346
    },
    "worst_day": {
      "day": 0,
      "day_name": "Sunday",
      "posts": 12,
      "avg_engagement": 92,
      "avg_views": 7100,
      "total_engagement": 1104
    },
    "best_hour": {
      "hour": 9,
      "posts": 27,
      "avg_engagement": 388,
      "avg_views": 26100,
      "total_engagement": 10476
    },
    "worst_hour": {
      "hour": 23,
      "posts": 6,
      "avg_engagement": 41,
      "avg_views": 3100,
      "total_engagement": 246
    },
    "day_summaries": [],
    "hour_summaries": [],
    "pattern": {
      "posts_per_day": 1.6,
      "posts_per_week": 11.2,
      "most_active_day": "Tuesday",
      "most_active_hour": "9:00 AM",
      "consistency": "consistent",
      "avg_hours_between_posts": 14.8,
      "weekday_vs_weekend": {
        "weekday_avg_engagement": 318,
        "weekend_avg_engagement": 121,
        "weekday_posts": 142,
        "weekend_posts": 38,
        "winner": "weekday",
        "difference": 162.8
      }
    },
    "engagement": {
      "engagement_rate": 0.31,
      "avg_likes": 284,
      "avg_retweets": 38,
      "avg_replies": 44,
      "avg_views": 21400
    },
    "timing_score": 74,
    "timing_grade": "good",
    "summary": {
      "recommendations": [
        "Tuesday 9:00 AM is this account's strongest slot by a wide margin.",
        "Weekend posts earn 62% less engagement. Move them into the week."
      ]
    }
  },
  "meta": {
    "request_id": "req_9f2c41a8b3d5",
    "generated_at": "2026-08-23T09:14:02.317Z",
    "took_ms": 42,
    "cache_age_s": 0
  }
}