> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shareofmodel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Asset Evaluation Results & Scores

> Retrieves complete results of a specific marketing asset evaluation, including all tested assets
with their AI-generated scores, recommendations, and performance analysis.

An asset evaluation contains AI-powered assessment results for marketing creative materials (ads, copy, images, videos,
landing pages). Each evaluation includes multiple assets with detailed scores across various dimensions (relevance,
clarity, persuasiveness, brand alignment), specific improvement recommendations, and comparative performance rankings.
Essential for understanding how AI models evaluate creative effectiveness and getting actionable feedback to optimize
marketing materials.

**When to use:** User wants to see evaluation results, review AI scores for specific assets, get improvement
recommendations, compare asset performance within an evaluation, understand why certain creative performed better,
or access detailed feedback on marketing materials.

**Common user queries:**
- "Show me the results of the Q1 Campaign evaluation"
- "Get the asset scores from the AI Campaign test"
- "What were the evaluation results for our ads?"
- "Show me AI feedback on our marketing assets"
- "Which assets scored highest in this evaluation?"
- "Get detailed recommendations for improving our creative"
- "What's the performance breakdown of evaluated assets?"
- "Show me the evaluation with all asset details"

**Returns:** Complete evaluation object with metadata, status, and optionally all assets with scores and recommendations.
Example: {"id": "uuid-456", "name": "Q1 Campaign Ads", "status": "completed",
"created_at": "2024-01-20T14:00:00Z", "asset_count": 5, "is_archived": false,
"assets": [{"id": "asset-1", "name": "Hero Ad", "type": "image", "content": "Try our new product!",
"overall_score": 8.5, "relevance_score": 9.0, "clarity_score": 8.0, "persuasiveness_score": 8.5,
"recommendations": ["Add stronger call-to-action", "Emphasize unique value proposition"],
"ranking": 1}]}

Required permission: `read:asset_evaluation`.



## OpenAPI

````yaml https://openapi.shareofmodel.ai/swagger.json get /v1/organizations/{organization_id}/workspaces/{workspace_id}/asset_evaluations/{id}
openapi: 3.0.3
info:
  title: Share Of Model API
  version: v1
  description: >-
    ## Model Context Protocol (MCP)


    In addition to this REST API, Share of Model exposes a **Model Context
    Protocol** server that lets AI assistants (Claude Desktop, Claude Code, MCP
    Inspector, custom agents…) call our endpoints directly as tools. Any
    MCP-compatible client can interact with Share of Model without writing
    custom integration code — connect once with your usual login and start
    asking the assistant to query the data for you.


    ### Connecting from Claude Desktop


    Open **Settings → Connectors**, scroll to the bottom and click **Add custom
    connector**, then paste `https://mcp.shareofmodel.ai/mcp/`. A browser window
    opens for you to log in with your Share of Model account (same login as the
    web app), and the assistant gains access to the tools.


    ### Connecting from Claude Code


    ```bash

    claude mcp add --transport http share-of-model
    https://mcp.shareofmodel.ai/mcp/

    ```


    The first time you call a tool, Claude Code opens your browser to complete
    the login.


    ### Connecting from MCP Inspector


    ```bash

    npx @modelcontextprotocol/inspector

    ```


    In the Inspector UI, pick **Streamable HTTP** as transport, paste
    `https://mcp.shareofmodel.ai/mcp/`, and click **Connect**. The first
    connection prompts you to log in.


    ### Available tools


    Only endpoints tagged `mcp` in this OpenAPI spec are exposed as MCP tools,
    and only read-only (`GET`) routes are exposed. Everything tagged `mcp` below
    is callable from any compliant MCP client.


    ### Example prompts


    Once connected, try asking your assistant things like:


    - _"List the workspaces I have access to."_

    - _"Show me the latest searches in workspace X."_

    - _"Compare the share of model between brand A and brand B over the last 30
    days."_


    For more details on the protocol itself, see the [Model Context Protocol
    specification](https://modelcontextprotocol.io/).
servers:
  - description: Production API
    url: https://api.shareofmodel.ai/
  - description: Development API
    url: https://api.dev.shareofmodel.ai/
security: []
tags:
  - name: Auth
    description: Endpoints needed for API authentication.
  - name: Organizations
    description: Endpoints related to organizations, to list all available organizations.
  - name: Workspaces
    description: Endpoints related to workspaces, to list all available workspaces.
  - name: Analyses
    description: Endpoints related to analyses and analyses management.
  - name: Asset Evaluations
    description: Endpoints related to assets and asset evaluations.
  - name: Brand Catalog
    description: Endpoints related to general brand information.
  - name: Content Briefs
    description: Endpoints related to content briefs generation and optimisation.
  - name: Metrics
    description: >+
      Endpoints related to brand metrics.


      **LEXICON**



      **Brand Awareness**: What opinion the LLMs have concerning specific
      brands, related to certain categories.



      **Brand Perception**: The general sentiment of the LLMs towards a brand,

      based on the pros and cons they mention.

paths:
  /v1/organizations/{organization_id}/workspaces/{workspace_id}/asset_evaluations/{id}:
    get:
      tags:
        - Asset Evaluations
      summary: Get Asset Evaluation Results & Scores
      description: >-
        Retrieves complete results of a specific marketing asset evaluation,
        including all tested assets

        with their AI-generated scores, recommendations, and performance
        analysis.


        An asset evaluation contains AI-powered assessment results for marketing
        creative materials (ads, copy, images, videos,

        landing pages). Each evaluation includes multiple assets with detailed
        scores across various dimensions (relevance,

        clarity, persuasiveness, brand alignment), specific improvement
        recommendations, and comparative performance rankings.

        Essential for understanding how AI models evaluate creative
        effectiveness and getting actionable feedback to optimize

        marketing materials.


        **When to use:** User wants to see evaluation results, review AI scores
        for specific assets, get improvement

        recommendations, compare asset performance within an evaluation,
        understand why certain creative performed better,

        or access detailed feedback on marketing materials.


        **Common user queries:**

        - "Show me the results of the Q1 Campaign evaluation"

        - "Get the asset scores from the AI Campaign test"

        - "What were the evaluation results for our ads?"

        - "Show me AI feedback on our marketing assets"

        - "Which assets scored highest in this evaluation?"

        - "Get detailed recommendations for improving our creative"

        - "What's the performance breakdown of evaluated assets?"

        - "Show me the evaluation with all asset details"


        **Returns:** Complete evaluation object with metadata, status, and
        optionally all assets with scores and recommendations.

        Example: {"id": "uuid-456", "name": "Q1 Campaign Ads", "status":
        "completed",

        "created_at": "2024-01-20T14:00:00Z", "asset_count": 5, "is_archived":
        false,

        "assets": [{"id": "asset-1", "name": "Hero Ad", "type": "image",
        "content": "Try our new product!",

        "overall_score": 8.5, "relevance_score": 9.0, "clarity_score": 8.0,
        "persuasiveness_score": 8.5,

        "recommendations": ["Add stronger call-to-action", "Emphasize unique
        value proposition"],

        "ranking": 1}]}


        Required permission: `read:asset_evaluation`.
      operationId: retrieve_asset_evaluation
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying this asset evaluation.
          required: true
        - in: query
          name: include_assets
          schema:
            type: boolean
          description: >-
            Include related assets with scores, recommendations, and detailed
            analysis in the response.
        - in: path
          name: organization_id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying the organization.
          required: true
        - in: path
          name: workspace_id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying the workspace.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetEvaluationWithAssets'
          description: ''
      security:
        - Bearer: []
components:
  schemas:
    AssetEvaluationWithAssets:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        assets:
          type: array
          items:
            $ref: '#/components/schemas/Asset'
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
          title: Created
        created_by:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        status:
          enum:
            - pending
            - in_progress
            - completed
            - partial
            - failed
          type: string
          description: |-
            * `pending` - pending
            * `in_progress` - in progress
            * `completed` - completed
            * `partial` - partial
            * `failed` - failed
          x-spec-enum-id: 07c86065df656b0c
        name:
          type: string
          maxLength: 255
        source:
          enum:
            - gpt-3.5-turbo
            - gpt-4-turbo
            - gpt-4o
            - gpt-4o-mini-search
            - gpt-5
            - gpt-5.2
            - gpt-5.4-mini
            - gemini-1.5-pro
            - gemini-2.0-flash
            - gemini-2.5-flash-grounded
            - gemini-2.5-flash
            - gemini-2.5-flash-lite
            - gemini-3-flash-preview
            - meta-llama-3.1-70B-instruct-turbo
            - meta-llama-3.2-70B-instruct-turbo
            - meta-llama-3.3-70B-instruct-turbo
            - meta-llama-4-maverick
            - mistral-7B-instruct
            - claude-3-5-sonnet
            - claude-4-sonnet
            - claude-4-5-sonnet
            - claude-4-6-sonnet
            - deepseek-chat
            - deepseek-reasoner
            - deepseek-v3.2-maas
            - perplexity-sonar
            - rufus
            - google-ai-mode
          type: string
          description: >-
            * `gpt-3.5-turbo` - gpt 3.5 turbo

            * `gpt-4-turbo` - gpt 4 turbo

            * `gpt-4o` - gpt 4o

            * `gpt-4o-mini-search` - gpt 4o mini search

            * `gpt-5` - gpt 5

            * `gpt-5.2` - gpt 5.2

            * `gpt-5.4-mini` - gpt 5.4 mini

            * `gemini-1.5-pro` - gemini 1.5 pro

            * `gemini-2.0-flash` - gemini 2.0 flash

            * `gemini-2.5-flash-grounded` - gemini 2.5 flash grounded

            * `gemini-2.5-flash` - gemini 2.5 flash

            * `gemini-2.5-flash-lite` - gemini 2.5 flash lite

            * `gemini-3-flash-preview` - gemini 3 flash preview

            * `meta-llama-3.1-70B-instruct-turbo` - meta llama 3.1 70B instruct
            turbo

            * `meta-llama-3.2-70B-instruct-turbo` - meta llama 3.2 70B instruct
            turbo

            * `meta-llama-3.3-70B-instruct-turbo` - meta llama 3.3 70B instruct
            turbo

            * `meta-llama-4-maverick` - meta llama 4 maverick

            * `mistral-7B-instruct` - mistral 7B instruct

            * `claude-3-5-sonnet` - claude 3 5 sonnet

            * `claude-4-sonnet` - claude 4 sonnet

            * `claude-4-5-sonnet` - claude 4 5 sonnet

            * `claude-4-6-sonnet` - claude 4 6 sonnet

            * `deepseek-chat` - deepseek chat

            * `deepseek-reasoner` - deepseek reasoner

            * `deepseek-v3.2-maas` - deepseek v3.2 maas

            * `perplexity-sonar` - perplexity sonar

            * `rufus` - rufus

            * `google-ai-mode` - google ai mode
          x-spec-enum-id: 31229724ccbe9afa
        brand:
          type: string
          maxLength: 255
        category:
          type: string
          maxLength: 255
        persona:
          type: string
          maxLength: 255
        attributes:
          type: array
          items:
            type: string
            maxLength: 255
        description:
          type: string
        is_archived:
          type: boolean
        communication_type:
          type: string
          maxLength: 255
        tags:
          type: array
          items:
            type: string
            maxLength: 255
        generation_cost:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
      required:
        - assets
        - brand
        - category
        - created_at
        - created_by
        - id
        - name
        - persona
        - source
        - workspace_id
    Asset:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        created_by_email:
          type: string
          nullable: true
        name:
          type: string
          maxLength: 255
        content_url:
          type: string
          maxLength: 255
        thumbnail_url:
          type: string
          maxLength: 255
        content_type:
          enum:
            - image
            - text
            - video
          type: string
          description: |-
            * `image` - image
            * `text` - text
            * `video` - video
          x-spec-enum-id: 0343cca47d7cc465
        content:
          type: string
        is_archived:
          type: boolean
        is_deleted:
          type: boolean
        tags:
          type: array
          items:
            type: string
            maxLength: 255
        created_at:
          type: string
          format: date-time
          nullable: true
        created_by:
          type: string
          format: uuid
          nullable: true
      required:
        - content
        - content_type
        - content_url
        - id
        - name
  securitySchemes:
    Bearer:
      type: apiKey
      in: header
      name: Authorization

````