Detect Suggested Objectives

Before computing benchmarks for a media, it is necessary to configure the media's Industry and use case segmentation. For more context on how Benchmarks are calculated please refer to our knowledge base.

This endpoint retrieves the a suggestion of objective configuration, which consists of an industry and use case segmentation auto-detected by our A.I.

NOTE: Our objective detection is carried out by an LLM (Gemini 2.5 Flash). Please ensure that you are compliant with your company's policies regarding GenAI.

A valid media UUID is required to be passed in the request's query parameters. This will run the auto-detection and serve the suggested configuration which the user can confirm or reject.

Explaining the fields

The purpose field refers to the primary objective of your content: Brand Building (BB) or Conversion. Read more about it here.

To provide the necessary industry sector context the fields industry_category and industry_subcategory can be used. Read more about it here.

To provide the necessary use case context the fields usecase_category,usecase_subcategory and platform can be used. Read more about it here.

Example of a successful response

For an image:

{
    "industry_category": "all",
    "industry_subcategory": "all",
    "usecase_category": "all",
    "usecase_subcategory": "all",
    "platform": "all",
    "purpose": "brand_building"
}

For a video:

{
    "industry_category": "all",
    "industry_subcategory": "all",
    "usecase_category": "all",
    "usecase_subcategory": "all",
    "platform": "all",
    "purpose": "brand_building"
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!