---
title: "Analyze Campaign New"
method: POST
path: "/api/v1/new-meta-analytics/analyze-campaign-new"
tags: ["newMetaAnalytics"]
---

# Analyze Campaign New

`POST /api/v1/new-meta-analytics/analyze-campaign-new`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/new-meta-analytics/analyze-campaign-new`
- Auth: HTTP bearer

Optimized analyze campaign API with better error handling and joins

## Query parameters

- `type` string, required
- `refresh` boolean: Force refresh analysis, ignore cache
- `campaign_id` string, nullable
- `adset_id` string, nullable
- `ad_id` string, nullable

## Request body

- BodyAnalyzeCampaignNewApiV1NewMetaAnalyticsAnalyzeCampaignNewPost
  - `target_json` object, required
  - `full_json` object, required

## Response `200`

Successful Response

- union
  - MetaAnalyticsSuccessResponse
    - `success` boolean
    - `entity_type` string, required
    - `entity_name` string, required
    - `threshold_met` boolean, required
    - `analysis` union, required
      - PerformanceAnalysisResponse
        - `executive_summary` string, required
        - `performance_optimization_blueprint` PerformanceOptimizationBlueprint, required
          - `spend_adjustment` string, required
          - `creative_fix` string, required
          - `audience_tweak` string, required
          - `ab_testing_ideas` string, required
        - `analyst_insights` string[], required
        - `campaign_performance_by_stage` CampaignPerformanceByStage, required
          - `awareness_stage` FunnelSectionAnalysis, required
            - `summary` string, required
            - `what_is_working` string[], required
            - `what_needs_improvement` string[], required
            - `how_to_improve` string[], required
          - `engagement_stage` FunnelSectionAnalysis, required
            - `summary` string, required
            - `what_is_working` string[], required
            - `what_needs_improvement` string[], required
            - `how_to_improve` string[], required
          - `conversion_stage` FunnelSectionAnalysis, required
            - `summary` string, required
            - `what_is_working` string[], required
            - `what_needs_improvement` string[], required
            - `how_to_improve` string[], required
        - `report` string, required
      - UnderperformingAnalysisResponse
        - `entity_analysis` EntityAnalysis, required
          - `entity_name` string, required
          - `entity_type` string, required
          - `status` string, required
          - `core_objective` string, required
          - `current_results` CurrentResults, required
            - `metric_key` string, required
            - `achieved` integer, required
            - `target` integer, required
            - `performance_gap` integer, required
            - `duration` string, required
          - `analysis` object, required
          - `final_notes` string, required
    - `cached_at` string, nullable
  - MetaAnalyticsSuccessResponseWithVideo
    - `success` boolean
    - `entity_type` string, required
    - `entity_name` string, required
    - `threshold_met` boolean, required
    - `analysis` union, required
      - PerformanceAnalysisResponse
        - `executive_summary` string, required
        - `performance_optimization_blueprint` PerformanceOptimizationBlueprint, required
          - `spend_adjustment` string, required
          - `creative_fix` string, required
          - `audience_tweak` string, required
          - `ab_testing_ideas` string, required
        - `analyst_insights` string[], required
        - `campaign_performance_by_stage` CampaignPerformanceByStage, required
          - `awareness_stage` FunnelSectionAnalysis, required
            - `summary` string, required
            - `what_is_working` string[], required
            - `what_needs_improvement` string[], required
            - `how_to_improve` string[], required
          - `engagement_stage` FunnelSectionAnalysis, required
            - `summary` string, required
            - `what_is_working` string[], required
            - `what_needs_improvement` string[], required
            - `how_to_improve` string[], required
          - `conversion_stage` FunnelSectionAnalysis, required
            - `summary` string, required
            - `what_is_working` string[], required
            - `what_needs_improvement` string[], required
            - `how_to_improve` string[], required
        - `report` string, required
      - UnderperformingAnalysisResponse
        - `entity_analysis` EntityAnalysis, required
          - `entity_name` string, required
          - `entity_type` string, required
          - `status` string, required
          - `core_objective` string, required
          - `current_results` CurrentResults, required
            - `metric_key` string, required
            - `achieved` integer, required
            - `target` integer, required
            - `performance_gap` integer, required
            - `duration` string, required
          - `analysis` object, required
          - `final_notes` string, required
    - `video_analysis` VideoAnalysisResponse, required
      - `entity_type` string, required
      - `entity_name` string, required
      - `video_summary` string, required
      - `top_funnel_analysis` TopFunnelAnalysis, required
        - `top_2_kpis` string[], required
        - `benchmark_comparison` string, required
        - `diagnosis` string, required
        - `creative_fix` string, required
      - `middle_funnel_analysis` MiddleFunnelAnalysis, required
        - `top_2_kpis` string[], required
        - `drop_off_point` string, required
        - `slope_interpretation` string, required
        - `creative_fix` string, required
      - `bottom_funnel_analysis` BottomFunnelAnalysis, required
        - `completion_rate_analysis` string, required
        - `cta_drop_off_analysis` string, required
        - `creative_fix` string, required
      - `action_conversion_analysis` ActionConversionAnalysis, required
        - `outbound_ctr_analysis` string, required
        - `cpc_vs_cpa_analysis` string, required
        - `creative_fix` string, required
      - `delivery_analysis` DeliveryAnalysis, required
        - `cpm_analysis` string, required
        - `frequency_analysis` string, required
        - `cost_efficiency` string, required
      - `video_timeline_analysis` VideoTimelineAnalysis[], required
        - `timestamp` string, required
        - `analysis` string, required
        - `fix` string, required
      - `creative_suggestions` string[], required
    - `cached_at` string, nullable
  - MetaAnalyticsErrorResponse
    - `success` boolean
    - `threshold_met` boolean, nullable
    - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/02d28bde684c?raw)