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`.

GET /v1/organizations/{organization_id}/workspaces/{workspace_id}/asset_evaluations/{id}

Get Asset Evaluation Results & Scores

cURL

curl --request GET \
  --url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/asset_evaluations/{id} \
  --header 'Authorization: <api-key>'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assets": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "content_url": "<string>",
      "content": "<string>",
      "created_by_email": "<string>",
      "thumbnail_url": "<string>",
      "is_archived": true,
      "is_deleted": true,
      "tags": [
        "<string>"
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "brand": "<string>",
  "category": "<string>",
  "persona": "<string>",
  "attributes": [
    "<string>"
  ],
  "description": "<string>",
  "is_archived": true,
  "communication_type": "<string>",
  "tags": [
    "<string>"
  ],
  "generation_cost": -1
}

Authorizations

Authorization · string · header · required

Path Parameters

id · string<uuid> · required

A UUID string identifying this asset evaluation.

organization_id · string<uuid> · required

A UUID string identifying the organization.

workspace_id · string<uuid> · required

A UUID string identifying the workspace.

Query Parameters

include_assets · boolean

Include related assets with scores, recommendations, and detailed analysis in the response.

Response

200 - application/json

id · string<uuid> · required · read-only

assets · object[] · required · read-only

Show child attributes

created_at · string<date-time> · required · read-only

created_by · string<uuid> · required

workspace_id · string<uuid> · required

name · string · required

Maximum string length: 255

source · enum<string> · required

• 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

Available options: 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

brand · string · required

Maximum string length: 255

category · string · required

Maximum string length: 255

persona · string · required

Maximum string length: 255

status · enum<string>

• pending - pending
• in_progress - in progress
• completed - completed
• partial - partial
• failed - failed

Available options: pending, in_progress, completed, partial, failed

attributes · string[]

Maximum string length: 255

description · string

is_archived · boolean

communication_type · string

Maximum string length: 255

tags · string[]

Maximum string length: 255

generation_cost · integer

Required range: -2147483648 <= x <= 2147483647