Skip to main content

Getting Product Details

Retrieve comprehensive product information using Trustana's unique product identifier (skuId). This endpoint provides access to complete product data including enrichment status, attributes, media, and operational details.

Integration Pre-requisites

Before retrieving product details, ensure you understand basic API requirements:

Product Identification:

  • Products are identified by their Trustana-generated skuId (format: TR08089326)
  • The skuId is returned when creating products or can be found via product search
  • Each skuId is unique across the entire Trustana platform

Access Requirements:

  • Valid API key with product read permissions
  • Product must exist and be accessible in your account
  • Deleted or archived products return 404 errors

See Creating Products for product creation and Searching Products for finding existing products.

Basic Product Retrieval​

Simple GET Request​

Retrieve complete product information using the Trustana skuId:

curl -X GET https://api.trustana.com/v1/products/TR08089326 \
  -H "X-API-Key: YOUR_API_KEY"

Success Response Example​

{
  "errorCode": 0,
  "data": {
    "id": "66b1e26390fbdbe71bebeda4",
    "skuId": "TR08089326",
    "supplierSku": "TEST005",
    "updatedAt": 1759843157715,
    "dataEnrichment": {
      "taskId": "ER01122365",
      "status": "FINISHED",
      "completedAt": 1722934566131
    },
    "attributeSummary": {
      "enrichableTotal": 55,
      "enrichableCompleted": 26,
      "enrichableCompletionRate": 47.27272727272727
    },
    "attributes": [
      {
        "key": "name",
        "value": "Germany National Team Home Jersey 2024"
      },
      {
        "key": "brand",
        "value": "Adidas"
      },
      {
        "key": "productCategory",
        "value": "2156"
      },
      {
        "key": "productModel",
        "value": "HT7599"
      },
      {
        "key": "color",
        "value": "White"
      },
      {
        "key": "size",
        "value": "M"
      },
      {
        "key": "price",
        "value": "89.99"
      },
      {
        "key": "material",
        "value": "100% Polyester"
      },
      {
        "key": "media",
        "value": [
          "IM03779818",
          "IM03779819",
          "IM03779820"
        ]
      },
      {
        "key": "smartShortDesp",
        "value": "Experience national pride with the official Germany National Team home jersey. Features moisture-wicking technology and authentic team design.",
        "blame": "ENRICHMENT_APPROVED"
      },
      {
        "key": "longDescription",
        "value": "Show your support for Die Mannschaft with this official Germany National Team home jersey. Crafted with Adidas' signature performance technology, this jersey features moisture-wicking fabric to keep you comfortable whether you're on the pitch or in the stands. The classic white design showcases the iconic German national team crest and Adidas three stripes. Perfect for match days, training, or casual wear.",
        "blame": "ENRICHMENT_APPROVED"
      },
      {
        "key": "features",
        "value": [
          "Official Germany National Team merchandise",
          "Moisture-wicking technology for comfort",
          "Authentic team crest and design",
          "Regular fit for all-day comfort",
          "Machine washable"
        ],
        "blame": "ENRICHMENT_APPROVED"
      },
      {
        "key": "specifications",
        "value": [
          "Material: 100% Polyester",
          "Care: Machine wash cold",
          "Origin: Made in Thailand",
          "Fit: Regular",
          "Season: 2024"
        ],
        "blame": "ENRICHMENT_APPROVED"
      }
    ]
  }
}

Response Structure Explained​

Core Product Information​

  • skuId: Trustana-generated unique identifier (TR08089326)
  • supplierSku: Your internal product identifier
  • id: MongoDB document identifier for internal system use
  • createdAt/updatedAt: Unix timestamps for audit tracking

Attribute Management​

  • attributes: Array of all product attributes with key-value pairs
  • attributeSummary: Enrichment progress metrics
    • enrichableTotal: Total attributes that can be AI-enriched
    • enrichableCompleted: Number of attributes with AI content
    • enrichableCompletionRate: Percentage of enrichment completion

Enrichment Tracking​

  • dataEnrichment: Information about AI enrichment task status
    • taskId: Unique identifier for the enrichment task (e.g., "ER01122365")
    • status: Current enrichment status (FINISHED, IN_PROGRESS, FAILED, PENDING)
    • completedAt: Unix timestamp when enrichment task completed

Content Attribution Tracking​

  • blame field: Each attribute may include a blame field indicating content source
    • ENRICHMENT_APPROVED: AI-generated content approved by users
    • ENRICHMENT: AI-generated content awaiting review
    • ENRICHMENT_REJECTED: AI-generated content rejected by users
    • Manually entered or API-provided attributes do not have blame

Example: User-provided attributes like name, brand, price have no blame field, while AI-enriched attributes like smartShortDesp include "blame": "ENRICHMENT_APPROVED".

Media References​

Media attributes contain arrays of image IDs that reference uploaded images:

{
  "key": "media",
  "value": ["IM03779818", "IM03779819", "IM03779820"]
}

These IDs can be used to retrieve actual image URLs through the media API endpoints.

Getting Variant Details​

Simple GET Request​

Retrieve variant information using the Trustana skuId:

curl -X GET https://api.trustana.com/v1/variants/{{skuId}} \
  -H "X-API-Key: YOUR_API_KEY"

The response structure for variants follows the same format as products, including attributes, enrichment data, and media references.

Common Use Cases​

Content Quality Review​

Assess enrichment quality and approve AI-generated content:

curl -X GET https://api.trustana.com/v1/products/TR08089326 \
  -H "X-API-Key: YOUR_API_KEY"

Review enrichment metrics:

  • Enrichment task status (dataEnrichment.status)
  • Task completion timestamp (dataEnrichment.completedAt)
  • Content attribution (blame field on individual attributes)
  • Completion percentage (attributeSummary.enrichableCompletionRate)

Error Handling​

Product Not Found​

{
  "errorCode": 404,
  "error": {
    "code": "product_not_found",
    "message": "Product with skuId 'TR08089326' not found",
    "suggestion": "Verify the skuId exists in your account or check if the product has been deleted"
  }
}

Invalid Authentication​

{
  "errorCode": 401,
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid or missing API key",
    "suggestion": "Ensure X-API-Key header contains a valid API key"
  }
}

Access Denied​

{
  "errorCode": 403,
  "error": {
    "code": "access_denied",
    "message": "Insufficient permissions to access product details",
    "suggestion": "Contact your account administrator to grant product read permissions"
  }
}