Attributes

Enrich Product Attributes

Fills missing product attribute values by researching the web — the brand's own site, Trendyol and Hepsiburada, a broader search, then Google's AI-mode summary — and reconciling what it finds with an LLM. Multi-step per product; reachable only through POST /v1/tasks. Flat 25 credits per product regardless of how many stages ran.

POST/v1/attributes/enrich25 creditsheavyqueue only

Calling this endpoint

The source behind this endpoint answers from a queue, and that queue outlives an HTTP request — so there is no live call to make. Queue it as a task and poll for the result; /v1/attributes/enrich itself answers 400 async_only.

curl --request POST 'https://data-api.roketfy.com/v1/tasks' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "platform": "attributes",
  "endpoint": "enrich",
  "params": {
    "products": [
      {
        "name": "Akıllı Saat X1",
        "brand": "Acme",
        "attributes": [
          {
            "key": "Ağırlık"
          },
          {
            "key": "Renk",
            "allowedValues": [
              "Siyah",
              "Beyaz",
              "Gri"
            ]
          },
          {
            "key": "Su Geçirmezlik"
          }
        ]
      }
    ]
  }
}'

See batch tasks for the full lifecycle.

Parameters

Name	Type	Required	Description
products	json	required	—
locale	string	optional	Drives query language and prompt language. Only "tr" is tuned today.

Example body

{
  "products": [
    {
      "name": "Akıllı Saat X1",
      "brand": "Acme",
      "attributes": [
        {
          "key": "Ağırlık"
        },
        {
          "key": "Renk",
          "allowedValues": [
            "Siyah",
            "Beyaz",
            "Gri"
          ]
        },
        {
          "key": "Su Geçirmezlik"
        }
      ]
    }
  ]
}

Request

curl --request POST 'https://data-api.roketfy.com/v1/attributes/enrich?products=%3Cproducts%3E' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "products": [
    {
      "name": "Akıllı Saat X1",
      "brand": "Acme",
      "attributes": [
        {
          "key": "Ağırlık"
        },
        {
          "key": "Renk",
          "allowedValues": [
            "Siyah",
            "Beyaz",
            "Gri"
          ]
        },
        {
          "key": "Su Geçirmezlik"
        }
      ]
    }
  ]
}'

MCP

Available to AI agents as the tool attributes_enrich, with the same parameters and the same credit cost. The tool queues a task and returns its id, like the HTTP flow above.