Overview

At its core, the Product Tagging functionality analyzes product descriptions, images, titles, and more to automatically generate predictive categories and tags. This AI-driven approach streamlines product organization, making items easier to search and discover, regardless of your chosen eCommerce platform.

Use case

A vendor uploads a new product to an eCommerce platform, including a detailed description and images of a "Vintage Leather Backpack." However, manually categorizing and tagging products can be time-consuming and may lack consistency. By using the Product Tagging API, the platform automatically analyzes the product's information and assigns it to the most relevant category (e.g., "Accessories > Bags") and generates tags such as "vintage," "leather," "backpack," enhancing product visibility and search relevance.

Example

The sample request outlined below demonstrates- how to use the Product Tagging API in AfterShip Personalization. By providing the necessary platform and product details, you can automatically analyze the information and assign appropriate categories and tags to the products.

To make the request, you need to specify the API endpoint URL and set the appropriate headers for content type, store ID, and API key. The request body includes the following parameters:

• Platform: Specifies the eCommerce platform for which the tagging is being performed (in this example, it’s "TTS").

• Product: Contains the details of the product for which tagging is required. It includes the source ID, title, description, image URLs, and variant information.

Sample Request

curl 'https://api.aftership.com/personalization/2025-01/discoveries/tagging' \
--header 'Content-Type: application/json' \
--header 'as-store-id: your commerce store id (not required)' \
--header 'as-api-key: your API key' \
--data '{
    "platform": "TTS",
    "product": {
        "source_id": "456212412",
        "title": "COVERGIRL Eye Enhancers 4-Kit Eyeshadow, 235 Pure Romance, 0.19 oz",
        "description": "COVERGIRL Eye Enhancers 4-Kit Eyeshadow, 235 Pure Romance, 0.19 oz. COVERGIRL Sheerly Nudes Eye Enhancers Eyeshadow Kit is the easiest way to create natural, flawless eyes that are perfect for your day AND nighttime looks! With its impeccably creamy-soft formula and incredible array of high-shimmer hues, you can wear anything from a light wash of beige hues, to bold taupes with reflective shimmer with this nude eyeshadow palette. You can also mix them all together for an ombre and natural eyeshadow look. But don'\''t forget about those adorable dual foam applicators in this eyeshadow palette. These easy-to-use wands have spongy tips so you can apply your eyeshadow in a breeze. BLENDS EASILY: The silky-sheer formula is easy to blend and buildable for perfect natural eyeshadow looks. SILKY SHEER FORMULA: Goes on smooth and stays put, so you can wear it alone or layer it with your favorite eyeshadow. DOUBLE ENDED APPLICATOR: The dual foam applicators have spongy tips for easy application. MULTIPLE OPTIONS: This eyeshadow palette is available in matte, pearly, & sparkly collections. CRUELTY FREE: We do not test our products on animals",
        "image_urls": [
            "https://i5.walmartimages.com/seo/COVERGIRL-Eye-Enhancers-4-Kit-Eyeshadow-235-Pure-Romance-0-19-oz_76734754-76dc-4a3b-9287-c5995daaae87.511e781327fa72fb79ea8d0d75c10c87.jpeg?odnHeight=2000&odnWidth=2000&odnBg=FFFFFF"
        ],
        "variant": {
            "source_id": "a92138421",
            "title": "blue / small"
        }
    }'

The response to this request will provide the assigned categories and generated tags for the product, enhancing its visibility and search relevance.

Sample Response

{
  "meta": {
    "code": 200,
    "type": "OK",
    "message": "Everything worked as expected."
  },
  "data": {
    "predict_category": {
      "category": "Beauty & Personal Care > Makeup > Eyeshadow",
      "confidence_score": 0.92
    },
    "predict_tags": [
      {
        "tag": "Edition|Limited Edition",
        "confidence_score": 0.7
      },
      {
        "tag": "Age Group|Youth",
        "confidence_score": 0.7
      },
      {
        "tag": "Net Weight|0.19 oz.",
        "confidence_score": 0.9
      },
      {
        "tag": "Quantity Per Pack|5",
        "confidence_score": 0.7
      },
      {
        "tag": "Color|235 Pure Romance",
        "confidence_score": 0.9
      },
      {
        "tag": "Alcohol Or Aerosol|Contains Aerosol",
        "confidence_score": 0.7
      },
      {
        "tag": "Country Of Origin|US",
        "confidence_score": 0.7
      },
      {
        "tag": "Franchise|COVERGIRL",
        "confidence_score": 0.9
      },
      {
        "tag": "Makeup Finish|Matte",
        "confidence_score": 0.7
      },
      {
        "tag": "Feature|BLENDS EASILY",
        "confidence_score": 0.9
      },
      {
        "tag": "Feature|SILKY SHEER FORMULA",
        "confidence_score": 0.9
      },
      {
        "tag": "Feature|DOUBLE ENDED APPLICATOR",
        "confidence_score": 0.9
      },
      {
        "tag": "Feature|MULTIPLE OPTIONS",
        "confidence_score": 0.9
      },
      {
        "tag": "Feature|CRUELTY FREE",
        "confidence_score": 0.9
      }
    ]
  }
}