curl --request POST \
  --url https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/social-group-insights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domains": [
    "<string>"
  ],
  "group_label": "<string>",
  "window_days": 30,
  "platforms": []
}
'

import requests

url = "https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/social-group-insights"

payload = {
    "domains": ["<string>"],
    "group_label": "<string>",
    "window_days": 30,
    "platforms": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domains: ['<string>'], group_label: '<string>', window_days: 30, platforms: []})
};

fetch('https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/social-group-insights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/social-group-insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domains' => [
        '<string>'
    ],
    'group_label' => '<string>',
    'window_days' => 30,
    'platforms' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/social-group-insights"

	payload := strings.NewReader("{\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"group_label\": \"<string>\",\n  \"window_days\": 30,\n  \"platforms\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/social-group-insights")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"group_label\": \"<string>\",\n  \"window_days\": 30,\n  \"platforms\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/social-group-insights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domains\": [\n    \"<string>\"\n  ],\n  \"group_label\": \"<string>\",\n  \"window_days\": 30,\n  \"platforms\": []\n}"

response = http.request(request)
puts response.read_body

{
  "brand_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "generated_at": "2023-11-07T05:31:56Z",
  "group_key": "<string>",
  "window": {
    "previous_start": "2023-11-07T05:31:56Z",
    "previous_end": "2023-11-07T05:31:56Z",
    "current_start": "2023-11-07T05:31:56Z",
    "current_end": "2023-11-07T05:31:56Z",
    "window_days": 30,
    "semantics": "half_open_utc"
  },
  "module": "social",
  "group_label": "<string>",
  "cohort_domains": [
    "<string>"
  ],
  "platforms": [
    "youtube"
  ],
  "coverage": {
    "availability": "unavailable",
    "targets_total": 0,
    "measured": 0,
    "missing": [
      "<string>"
    ],
    "fetch_failed": [
      "<string>"
    ],
    "persist_failed": [
      "<string>"
    ],
    "outcome_unknown": [
      "<string>"
    ],
    "fresh": 0,
    "stale": 0,
    "freshness_threshold_hours": 48,
    "rows": [
      {
        "domain": "<string>",
        "platform": "youtube",
        "status": "measured",
        "captured_at": "2023-11-07T05:31:56Z",
        "age_hours": 123,
        "freshness": "missing"
      }
    ]
  },
  "pulse": {
    "availability": "unavailable",
    "posts": {
      "current": 123,
      "previous": 123,
      "delta_pct": 123,
      "paired_profiles": 0,
      "sample_size": 0,
      "comparison_status": "not_comparable",
      "lower_bound": false
    },
    "posting_profiles": {
      "current": 123,
      "previous": 123,
      "delta_pct": 123,
      "paired_profiles": 0,
      "sample_size": 0,
      "comparison_status": "not_comparable",
      "lower_bound": false
    },
    "active_brands": {
      "current": 123,
      "previous": 123,
      "delta_pct": 123,
      "paired_profiles": 0,
      "sample_size": 0,
      "comparison_status": "not_comparable",
      "lower_bound": false
    },
    "median_posts_per_active_brand": {
      "current": 123,
      "previous": 123,
      "delta_pct": 123,
      "paired_profiles": 0,
      "sample_size": 0,
      "comparison_status": "not_comparable",
      "lower_bound": false
    },
    "active_platforms": {
      "current": 123,
      "previous": 123,
      "delta_pct": 123,
      "paired_profiles": 0,
      "sample_size": 0,
      "comparison_status": "not_comparable",
      "lower_bound": false
    },
    "measured_profile_coverage_pct": 123,
    "sample_size": 0,
    "lower_bound": true
  },
  "format_mix": {
    "availability": "unavailable",
    "rows": [
      {
        "signal_key": "<string>",
        "platform": "youtube",
        "format": "video",
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "current_share_pct": 123,
        "previous_share_pct": 123,
        "lift_pct_points": 123,
        "brands_current": 0,
        "brands_previous": 0
      }
    ],
    "lift_signals": [
      {
        "signal_key": "<string>",
        "platform": "youtube",
        "format": "video",
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "current_share_pct": 123,
        "previous_share_pct": 123,
        "lift_pct_points": 123,
        "brands_current": 0,
        "brands_previous": 0
      }
    ],
    "sample_size": 0,
    "lower_bound": true
  },
  "platform_footprint": {
    "availability": "unavailable",
    "rows": [
      {
        "signal_key": "<string>",
        "platform": "youtube",
        "profiles_total": 0,
        "profiles_measured": 0,
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "active_brands": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "current_post_share_pct": 123
      }
    ],
    "top_platform": "youtube",
    "top_platform_share_pct": 123,
    "sample_size": 0,
    "lower_bound": true
  },
  "brand_leaderboard": {
    "availability": "unavailable",
    "scope": "all_platforms",
    "rows": [
      {
        "domain": "<string>",
        "rank": 2,
        "tied_count": 2,
        "platform": "youtube",
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "active_profiles": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "active_days": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "follower_snapshot": 123,
        "follower_captured_at": "2023-11-07T05:31:56Z",
        "follower_change": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "median_visible_interactions": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "follower_normalized_rate": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        }
      }
    ],
    "sample_size": 0,
    "lower_bound": true
  },
  "publishing_rhythm": {
    "availability": "unavailable",
    "rows": [
      {
        "signal_key": "<string>",
        "platform": "youtube",
        "weekday": 3,
        "weekday_label": "<string>",
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "current_share_pct": 123,
        "previous_share_pct": 123
      }
    ],
    "top_brand_domain": "<string>",
    "top_brand_share_pct": 123,
    "sample_size": 0,
    "lower_bound": true
  },
  "trends": {
    "availability": "unavailable",
    "granularity": "day",
    "rows": [
      {
        "signal_key": "<string>",
        "platform": "youtube",
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "points": [
          {
            "index": 1,
            "current_at": "2023-11-07T05:31:56Z",
            "previous_at": "2023-11-07T05:31:56Z",
            "current_posts": 123,
            "previous_posts": 123
          }
        ]
      }
    ],
    "sample_size": 0,
    "lower_bound": true
  },
  "topics_hashtags": {
    "availability": "unavailable",
    "top_terms": [
      {
        "signal_key": "<string>",
        "platform": "youtube",
        "kind": "topic",
        "value": "<string>",
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "current_share_pct": 123,
        "previous_share_pct": 123,
        "lift_pct_points": 123,
        "brands_current": 0,
        "brands_previous": 0
      }
    ],
    "lift_signals": [
      {
        "signal_key": "<string>",
        "platform": "youtube",
        "kind": "topic",
        "value": "<string>",
        "posts": {
          "current": 123,
          "previous": 123,
          "delta_pct": 123,
          "paired_profiles": 0,
          "sample_size": 0,
          "comparison_status": "not_comparable",
          "lower_bound": false
        },
        "current_share_pct": 123,
        "previous_share_pct": 123,
        "lift_pct_points": 123,
        "brands_current": 0,
        "brands_previous": 0
      }
    ],
    "sample_size": 0,
    "lower_bound": true
  },
  "top_posts": {
    "availability": "unavailable",
    "posts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "domain": "<string>",
        "platform": "youtube",
        "title": "<string>",
        "published_at": "2023-11-07T05:31:56Z",
        "excerpt": "<string>",
        "url": "<string>",
        "media_type": "<string>",
        "visible_interactions": 123,
        "views": 123,
        "likes": 123,
        "comments": 123,
        "shares": 123,
        "topics": [
          "<string>"
        ],
        "hashtags": [
          "<string>"
        ],
        "performance_index": 50,
        "performance_metric": "engagements",
        "performance_sample_size": 0,
        "performance_baseline_median": 123,
        "performance_note": "<string>"
      }
    ],
    "sample_size": 0,
    "lower_bound": true
  },
  "findings": [
    {
      "rule_id": "<string>",
      "module": "seo",
      "panel": "<string>",
      "title": "<string>",
      "detail": "<string>",
      "severity": "info",
      "evidence_refs": [
        "<string>"
      ]
    }
  ],
  "provenance": {
    "source_tables": [
      "<string>"
    ],
    "window_semantics": "half_open_utc",
    "domain_platform_pairs_requested": 0,
    "domain_platform_pairs_compared": 0,
    "metric_rows": 0,
    "snapshot_rows": 0,
    "refresh_runs": 0,
    "observation_rows": 0,
    "canonical_items": 0,
    "lower_bound": true
  },
  "sample_basis_notice": "Computed from canonical public posts observed in stored competitor snapshots. Post counts and visible interactions are lower bounds, not complete platform firehoses; unavailable public metrics remain null."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}