Get Brand Intelligence Own Brand Insights Route

curl --request GET \
  --url https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/own-brand-insights \
  --header 'Authorization: Bearer <token>'

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/own-brand-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/own-brand-insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "generated_at": "2023-11-07T05:31:56Z",
  "own_brand_state": "not_resolved",
  "advertiser_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "brand_label": "<string>",
  "classified_ads": 0,
  "insights": {
    "generated_at": "2023-11-07T05:31:56Z",
    "group_key": "<string>",
    "signals": {
      "total_ads": 0,
      "active_ads": 0,
      "inactive_ads": 0,
      "dated_ads": 0,
      "themed_ads": 0,
      "new_ads_30d": 0,
      "new_ads_14d": 0,
      "new_ads_7d": 0,
      "first_seen_at": "2023-11-07T05:31:56Z",
      "last_seen_at": "2023-11-07T05:31:56Z",
      "longest_active_days": 123,
      "avg_active_days": 123,
      "run_length_measured_ads": 0,
      "distinct_concepts": 0,
      "avg_video_duration_seconds": 123,
      "platforms": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "formats": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "landing_domains": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "landing_pages": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "hooks": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "ctas": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "countries": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "languages": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "industries": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "themes": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "launched_by_month": [
        {
          "month": "<string>",
          "count": 0
        }
      ]
    },
    "group_label": "<string>",
    "brand_count": 0,
    "dated_ad_count": 0,
    "date_from": "2023-12-25",
    "date_to": "2023-12-25",
    "brands": [
      {
        "advertiser_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "domain": "<string>",
        "total_ads": 0,
        "active_ads": 0,
        "new_ads_30d": 0,
        "image_ads": 0,
        "video_ads": 0,
        "other_ads": 0,
        "dated_ads": 0,
        "platform_mapped_ads": 0,
        "platform_mapped_image_ads": 0,
        "platform_mapped_video_ads": 0,
        "platform_mapped_other_ads": 0,
        "platforms": [
          {
            "key": "<string>",
            "count": 0,
            "image_count": 0,
            "video_count": 0,
            "other_count": 0
          }
        ],
        "themed_ads": 0,
        "themes": [
          {
            "key": "<string>",
            "count": 0,
            "image_count": 0,
            "video_count": 0,
            "other_count": 0
          }
        ],
        "last_seen_at": "2023-11-07T05:31:56Z"
      }
    ],
    "launched_by_weekday": [
      {
        "weekday": 3,
        "total": 0,
        "brands": [
          {
            "key": "<string>",
            "count": 0,
            "image_count": 0,
            "video_count": 0,
            "other_count": 0
          }
        ]
      }
    ],
    "own_brand": {
      "advertiser_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "domain": "<string>",
      "total_ads": 0,
      "active_ads": 0,
      "new_ads_30d": 0,
      "image_ads": 0,
      "video_ads": 0,
      "other_ads": 0,
      "dated_ads": 0,
      "platform_mapped_ads": 0,
      "platform_mapped_image_ads": 0,
      "platform_mapped_video_ads": 0,
      "platform_mapped_other_ads": 0,
      "platforms": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "themed_ads": 0,
      "themes": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "last_seen_at": "2023-11-07T05:31:56Z"
    },
    "own_brand_state": "not_resolved",
    "own_brand_classified_ads": 0,
    "dominant_industry": "<string>"
  }
}

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

Brand Intelligence

Get Brand Intelligence Own Brand Insights Route

The n=1 Insights section on Analyze My Ads, for the caller’s OWN brand.

GET, not POST: unlike the group-insights endpoint there is no client-curated advertiser set to carry. The subject is resolved server-side from the caller’s own Brand by domain match, so no caller-supplied advertiser id ever reaches the aggregation — which is also why no visible_advertiser_ids narrowing is needed here.

ADR 0021: that resolution goes through review_advertiser_identity.owned_brand_advertiser_lookup_statement and never through brand_intel_tracked_group_members — see brand_digest_service.get_own_brand_insights.

platform narrows which of the brand’s own creatives are counted, and a caller that renders this beneath a single-platform feed must send it. The resolved advertiser is a canonical identity spanning every platform the brand advertises on, so WITHOUT it a Google-scoped surface would describe the brand’s Meta ads too. Omitting it keeps the all-platform behaviour Paid Media’s section already has, so no existing caller changes.

Flags: no new flag (the rollout plan is explicit that this surface needs none — it is new UI over already-shipped computation, with no new acquisition and no new LLM call). It composes the two existing gates it actually reads through: the BI master switch and the shared group-insights switch, since this IS the group-insights pipeline.

GET

api

brands

{brand_id}

brand-intelligence

own-brand-insights

Get Brand Intelligence Own Brand Insights Route

curl --request GET \
  --url https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/own-brand-insights \
  --header 'Authorization: Bearer <token>'

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/api/v1/brands/{brand_id}/brand-intelligence/own-brand-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/own-brand-insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "generated_at": "2023-11-07T05:31:56Z",
  "own_brand_state": "not_resolved",
  "advertiser_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "brand_label": "<string>",
  "classified_ads": 0,
  "insights": {
    "generated_at": "2023-11-07T05:31:56Z",
    "group_key": "<string>",
    "signals": {
      "total_ads": 0,
      "active_ads": 0,
      "inactive_ads": 0,
      "dated_ads": 0,
      "themed_ads": 0,
      "new_ads_30d": 0,
      "new_ads_14d": 0,
      "new_ads_7d": 0,
      "first_seen_at": "2023-11-07T05:31:56Z",
      "last_seen_at": "2023-11-07T05:31:56Z",
      "longest_active_days": 123,
      "avg_active_days": 123,
      "run_length_measured_ads": 0,
      "distinct_concepts": 0,
      "avg_video_duration_seconds": 123,
      "platforms": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "formats": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "landing_domains": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "landing_pages": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "hooks": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "ctas": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "countries": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "languages": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "industries": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "themes": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "launched_by_month": [
        {
          "month": "<string>",
          "count": 0
        }
      ]
    },
    "group_label": "<string>",
    "brand_count": 0,
    "dated_ad_count": 0,
    "date_from": "2023-12-25",
    "date_to": "2023-12-25",
    "brands": [
      {
        "advertiser_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "domain": "<string>",
        "total_ads": 0,
        "active_ads": 0,
        "new_ads_30d": 0,
        "image_ads": 0,
        "video_ads": 0,
        "other_ads": 0,
        "dated_ads": 0,
        "platform_mapped_ads": 0,
        "platform_mapped_image_ads": 0,
        "platform_mapped_video_ads": 0,
        "platform_mapped_other_ads": 0,
        "platforms": [
          {
            "key": "<string>",
            "count": 0,
            "image_count": 0,
            "video_count": 0,
            "other_count": 0
          }
        ],
        "themed_ads": 0,
        "themes": [
          {
            "key": "<string>",
            "count": 0,
            "image_count": 0,
            "video_count": 0,
            "other_count": 0
          }
        ],
        "last_seen_at": "2023-11-07T05:31:56Z"
      }
    ],
    "launched_by_weekday": [
      {
        "weekday": 3,
        "total": 0,
        "brands": [
          {
            "key": "<string>",
            "count": 0,
            "image_count": 0,
            "video_count": 0,
            "other_count": 0
          }
        ]
      }
    ],
    "own_brand": {
      "advertiser_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "domain": "<string>",
      "total_ads": 0,
      "active_ads": 0,
      "new_ads_30d": 0,
      "image_ads": 0,
      "video_ads": 0,
      "other_ads": 0,
      "dated_ads": 0,
      "platform_mapped_ads": 0,
      "platform_mapped_image_ads": 0,
      "platform_mapped_video_ads": 0,
      "platform_mapped_other_ads": 0,
      "platforms": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "themed_ads": 0,
      "themes": [
        {
          "key": "<string>",
          "count": 0,
          "image_count": 0,
          "video_count": 0,
          "other_count": 0
        }
      ],
      "last_seen_at": "2023-11-07T05:31:56Z"
    },
    "own_brand_state": "not_resolved",
    "own_brand_classified_ads": 0,
    "dominant_industry": "<string>"
  }
}

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

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id

string<uuid>

required

Query Parameters

platform

string | null

Maximum string length: 200

Response

Successful Response

Paid Media > Analyze My Ads > the MY BRAND (n=1) Insights section.

The SAME single-advertiser aggregation the brand digest already runs (brand_digest_service.get_brand_digest_insights over group_insights_service.build_group_insights), pointed at the reader's OWN advertiser instead of a tracked competitor's.

The subject is resolved server-side from the caller's own Brand via review_advertiser_identity.owned_brand_advertiser_lookup_statement (the domain match), NEVER from brand_intel_tracked_group_members — ADR 0021 reserves that table for competitor cohort membership, and reading it here would pull global ad-library cohort scope into a per-brand surface.

insights is the untouched group-insights payload for a one-member set, so the section reuses the same primitives the group INSIGHTS tab does. Only the n=1-meaningful reads are rendered from it — format / platform mix, longevity, Top Hooks, launch cadence. The comparison-shaped reads (whitespace matrix, quadrant, cohort read) are structurally cohort features and have no meaning over one advertiser.

generated_at

string<date-time>

required

own_brand_state

enum<string>

default:not_resolved

Available options:

measured,

not_resolved,

no_ads,

below_minimum

advertiser_id

string<uuid> | null

brand_label

string | null

classified_ads

integer

default:0

insights

BrandIntelligenceGroupInsightsResponse · object | null

Show child attributes

Overview

Endpoints

Get Brand Intelligence Own Brand Insights Route

Authorizations

Path Parameters

Query Parameters

Response