Recipes for agents

// data = the "data" object of an instagram.reels, instagram.photos or x.posts response
function metrics(data) {
  const items = data.reels ?? data.posts ?? [];
  const followers = data.follower_count;
  const median = (xs) => {
    const s = xs.filter((x) => typeof x === "number").sort((a, b) => a - b);
    if (!s.length) return null;
    const m = Math.floor(s.length / 2);
    return s.length % 2 ? s[m] : (s[m - 1] + s[m]) / 2;
  };

  // Engagement rate per post: interactions / followers x 100. Skip posts whose counts are hidden.
  const rates = items
    .filter((p) => !p.like_and_view_counts_disabled && typeof p.like_count === "number")
    .map((p) => {
      const interactions =
        p.like_count + (p.comment_count ?? 0) + (p.reply_count ?? 0) + (p.retweet_count ?? 0) + (p.quote_count ?? 0);
      return followers ? (interactions / followers) * 100 : null;
    });

  // Posts per week: Instagram taken_at is Unix seconds, X created_at is a date string
  const times = items
    .map((p) => (typeof p.taken_at === "number" ? p.taken_at * 1000 : Date.parse(p.created_at)))
    .filter((t) => Number.isFinite(t))
    .sort((a, b) => a - b);
  const weeks = times.length > 1 ? (times.at(-1) - times[0]) / (7 * 24 * 3600 * 1000) : null;

  return {
    posts: items.length,
    median_engagement_rate: median(rates),
    median_views: median(items.map((p) => p.view_count)),
    posts_per_week: weeks ? (times.length - 1) / weeks : null,
  };
}

curl -s -X POST https://api.scrapeeverything.com/v1/instagram/reels \
  -H "Authorization: Bearer $SCRAPEEVERYTHING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "nasa", "limit": 12}' | wc -c