Skip to main content
Glama

LeoWorks Review & Lead Data Tools (via Apify MCP)

leoworks/aliexpress-reviews-classifier

leoworks--aliexpress-reviews-classifier
Destructive

This tool calls the Actor "leoworks/aliexpress-reviews-classifier" and retrieves its output results. Actor description: AliExpress reviews scraper with review analysis: translation, stars, country, photos; AliExpress review complaints and sentiment. Use for known products; for keyword search use leoworks/aliexpress-search-scraper. productUrls or IDs. No login, ~8 min/1,000 reviews, pay per review.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "productUrls": "<productUrls>"
    },
    "name": "leoworks--aliexpress-reviews-classifier"
  }
}

Input Schema

NameRequiredDescriptionDefault
countryNoTwo-letter country code used for the request (affects which reviews AliExpress shows first and the translation language base). Default US. Example values: "US"US
keywordsNoKeep only reviews whose text, English translation or follow-up contains one of these words (not case-sensitive), e.g. "broken", "battery", "size".
maxStarsNoKeep only reviews with at most this many stars — e.g. 3 to read only the critical ones before sourcing a product.
minStarsNoKeep only reviews with at least this many stars. Leave empty for all.
waitSecsNoMax seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget.
monitorKeyNoAny name for this watch list, e.g. `my-suppliers`. Run again with the same key and each product row gets `previousRunAt`, `ratingDelta`, `newReviews` and `newCriticalIssues` (new reviews that need action) — the change since the last run with that key; the first run only saves the baseline. Leave empty to switch comparison off. [Description truncated]
healthCheckNoInternal: fail the run when results look degraded (used by the developer's scheduled checks).
productUrlsYes**REQUIRED** AliExpress product pages (any site: www.aliexpress.com, aliexpress.us, ko.aliexpress.com …) or product IDs, e.g. https://www.aliexpress.com/item/1005008549911526.html or 1005008549911526. Example values: ["https://www.aliexpress.com/item/1005008549911526.html"]
customLabelsNoUp to 10 yes/no criteria in plain language, e.g. "arrived broken or damaged", "mentions the battery", "looks different from the photos". Each classified review gets a probability and `matched` per label. Included in the classification price.
photoJudgingNoAdds `photoEvidence` (supports_complaint_product, supports_complaint_packaging, damage_seen_text_silent, no_evidence, not_product_photo) and puts photo-backed product defects, then photo-backed packaging damage, at the top of ACTION_QUEUE.csv. "Only reviews with a complaint or 3 stars or fewer" judges far fewer photos and is the recommended setting. Example values: "off"off
photoMaxSideNoLongest side in pixels requested from the photo server (512, 768 or 1024; other values are rounded). Smaller is faster; photos under 280 pixels on the short side are skipped. Example values: 768
reviewFilterNoReviews come in AliExpress' default order. Star and date sorting are not offered by the source. "Only reviews from buyers in the shipping country" uses the Shipping country under Advanced. Example values: "all"all
buyerCountriesNoKeep only reviews from buyers in these countries (two-letter codes, e.g. US, FR, BR).
maxConcurrencyNoProducts processed in parallel. Example values: 5
classifyReviewsNoAdd complaint types (delivery, quality/defect, size/fit, price/value, customer service, packaging, no effect, skin/body reaction, other), sentiment and purchase motive to each review. Reviews in other languages are classified from AliExpress' English translation. Adds $0.5 per 1,000 classified reviews on top of the $1.5 per 1,000 collection price — turn off for collection only. Example values: true
includeStarOnlyNoAliExpress has many reviews with a star rating but no text or photos. They are skipped (not charged) by default; turn this on to collect them too (charged as review).
reviewsNewerThanNoA date (`2026-09-01`) or a period (`30 days`, `6 months`).
reviewsPerProductNoMaximum reviews to collect for each product (charged per review: $1.5 per 1,000, or $2.0 per 1,000 with AI classification). The form starts at 20 for a quick, low-cost first run; raise it up to 5,000 (default when omitted via API: 100). Example values: 20
complaintThresholdNoMinimum probability (0–1) for a complaint type to be reported. Example values: 0.5
maxPhotosPerReviewNoThe first photos of each review. With "All reviews that have photos", at most 2 photos per review are judged. Example values: 2
proxyConfigurationNoDefault Apify datacenter proxy works. Example values: {"useApifyProxy":true}
residentialFallbackNoRetry failing requests through residential proxy in the shipping country. Example values: true

Output Schema

NameRequiredDescriptionDefault
tipNoAdvisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key
runIdYesActor run ID
statsNoRun statistics
statusYesRun status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
actorIdYesStable Apify Actor ID from the run record
summaryYesPast-tense summary of the run state
exitCodeNoActor process exit code; populated for terminal states (especially FAILED)
nextStepYesOne primary follow-up action with identifiers interpolated
storagesYesDataset and key-value store metadata, keyed by alias. "default" is always the primary entry.
actorNameNo"username/actor-name"
startedAtNoISO timestamp when the run started
finishedAtNoISO timestamp when the run finished (terminal states only)
statusMessageNoPass-through from Apify run.statusMessage
apifyConsoleUrlNoPersonalized Apify Console link to the run; present only for Console sessions

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / additionalProperties / properties / fields / description
      Previous value: -"Dataset field paths in dot notation (e.g. [\"metadata.url\"])"New value: +"Paths that work as a fields selection (e.g. [\"results\", \"metadata.url\"]); an array field appears by its top-level name."
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / fields / description
      Previous value: -"Dataset field paths in dot notation (e.g. [\"metadata.url\"])"New value: +"Paths that work as a fields selection (e.g. [\"results\", \"metadata.url\"]); an array field appears by its top-level name."
  2. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "additionalReview": {},
      +    "aiWritten": {
      +      "type": "boolean"
      +    },
      +    "aspects": {
      +      "items": {
      +        "properties": {
      +          "aspect": {
      +            "type": "string"
      +          },
      +          "rating": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "classifiedFrom": {
      +      "type": "string"
      +    },
      +    "complaintTypes": {
      +      "type": "string"
      +    },
      +    "country": {
      +      "type": "string"
      +    },
      +    "date": {
      +      "type": "string"
      +    },
      +    "featured": {
      +      "type": "boolean"
      +    },
      +    "hasFollowUp": {
      +      "type": "boolean"
      +    },
      +    "helpfulVotes": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "images": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "labels": {
      +      "properties": {
      +        "complaint": {
      +          "items": {
      +            "properties": {
      +              "label": {
      +                "type": "string"
      +              },
      +              "labelKo": {
      +                "type": "string"
      +              },
      +              "probability": {
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "motive": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "sentiment": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "logistics": {
      +      "type": "string"
      +    },
      +    "motive": {
      +      "type": "string"
      +    },
      +    "option": {
      +      "type": "string"
      +    },
      +    "productId": {
      +      "type": "string"
      +    },
      +    "productUrl": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "reviewId": {
      +      "type": "string"
      +    },
      +    "sentiment": {
      +      "type": "string"
      +    },
      +    "starTextMismatch": {
      +      "type": "boolean"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "textEnglish": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "type": {
      +      "type": "string"
      +    },
      +    "unhelpfulVotes": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "additionalReview": {},
      -    "aiWritten": {
      -      "type": "boolean"
      -    },
      -    "aspects": {
      -      "items": {
      -        "properties": {
      -          "aspect": {
      -            "type": "string"
      -          },
      -          "rating": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "classifiedFrom": {
      -      "type": "string"
      -    },
      -    "complaintTypes": {
      -      "type": "string"
      -    },
      -    "country": {
      -      "type": "string"
      -    },
      -    "date": {
      -      "type": "string"
      -    },
      -    "featured": {
      -      "type": "boolean"
      -    },
      -    "hasFollowUp": {
      -      "type": "boolean"
      -    },
      -    "helpfulVotes": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "images": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "labels": {
      -      "properties": {
      -        "complaint": {
      -          "items": {
      -            "properties": {
      -              "label": {
      -                "type": "string"
      -              },
      -              "labelKo": {
      -                "type": "string"
      -              },
      -              "probability": {
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "motive": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "sentiment": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "logistics": {
      -      "type": "string"
      -    },
      -    "motive": {
      -      "type": "string"
      -    },
      -    "option": {
      -      "type": "string"
      -    },
      -    "productId": {
      -      "type": "string"
      -    },
      -    "productUrl": {
      -      "type": "string"
      -    },
      -    "rating": {
      -      "type": "number"
      -    },
      -    "reviewId": {
      -      "type": "string"
      -    },
      -    "sentiment": {
      -      "type": "string"
      -    },
      -    "starTextMismatch": {
      -      "type": "boolean"
      -    },
      -    "text": {
      -      "type": "string"
      -    },
      -    "textEnglish": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "type": {
      -      "type": "string"
      -    },
      -    "unhelpfulVotes": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  4. Changed1 schema field changed
    • addedInput schema / properties / monitorKey
      Added value: +{
      +  "description": "Any name for this watch list, e.g. `my-suppliers`. Run again with the same key and each product row gets `previousRunAt`, `ratingDelta`, `newReviews` and `newCriticalIssues` (new reviews that need action) — the change since the last run with that key; the first run only saves the baseline. Leave empty to switch comparison off.\n\n[Description truncated]",
      +  "title": "Monitor key (compare with the last run)",
      +  "type": "string"
      +}
  5. Changed6 schema fields changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / classifySkipped
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoEvidence
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoLabels
      Removed value: -{
      -  "properties": {
      -    "isRealItem": {
      -      "type": "number"
      -    },
      -    "model": {
      -      "type": "string"
      -    },
      -    "packagingDamage": {
      -      "type": "number"
      -    },
      -    "perPhoto": {
      -      "items": {
      -        "properties": {
      -          "height": {
      -            "type": "number"
      -          },
      -          "isRealItem": {
      -            "type": "number"
      -          },
      -          "matchesText": {
      -            "type": "number"
      -          },
      -          "packagingDamage": {
      -            "type": "number"
      -          },
      -          "productDamage": {
      -            "type": "number"
      -          },
      -          "width": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "productDamage": {
      -      "type": "number"
      -    },
      -    "questions": {
      -      "type": "string"
      -    },
      -    "supportsComplaint": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoStatus
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoUrl
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photosJudged
      Removed value: -{
      -  "type": "number"
      -}
  6. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / additionalReview / type
      Removed value: -"null"
  7. Changed11 schema fields changed
    • addedInput schema / properties / maxPhotosPerReview
      Added value: +{
      +  "default": 2,
      +  "description": "The first photos of each review. With \"All reviews that have photos\", at most 2 photos per review are judged.\nExample values: 2",
      +  "examples": [
      +    2
      +  ],
      +  "title": "Photos judged per review",
      +  "type": "integer"
      +}
    • addedInput schema / properties / photoJudging
      Added value: +{
      +  "default": "off",
      +  "description": "Adds `photoEvidence` (supports_complaint_product, supports_complaint_packaging, damage_seen_text_silent, no_evidence, not_product_photo) and puts photo-backed product defects, then photo-backed packaging damage, at the top of ACTION_QUEUE.csv. \"Only reviews with a complaint or 3 stars or fewer\" judges far fewer photos and is the recommended setting.\nExample values: \"off\"",
      +  "enum": [
      +    "off",
      +    "complaints",
      +    "all"
      +  ],
      +  "examples": [
      +    "off"
      +  ],
      +  "title": "Judge review photos (beta)",
      +  "type": "string"
      +}
    • addedInput schema / properties / photoMaxSide
      Added value: +{
      +  "default": 768,
      +  "description": "Longest side in pixels requested from the photo server (512, 768 or 1024; other values are rounded). Smaller is faster; photos under 280 pixels on the short side are skipped.\nExample values: 768",
      +  "examples": [
      +    768
      +  ],
      +  "title": "Photo size",
      +  "type": "integer"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / additionalReview / type
      Added value: +"null"
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / classifySkipped
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoEvidence
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoLabels
      Added value: +{
      +  "properties": {
      +    "isRealItem": {
      +      "type": "number"
      +    },
      +    "model": {
      +      "type": "string"
      +    },
      +    "packagingDamage": {
      +      "type": "number"
      +    },
      +    "perPhoto": {
      +      "items": {
      +        "properties": {
      +          "height": {
      +            "type": "number"
      +          },
      +          "isRealItem": {
      +            "type": "number"
      +          },
      +          "matchesText": {
      +            "type": "number"
      +          },
      +          "packagingDamage": {
      +            "type": "number"
      +          },
      +          "productDamage": {
      +            "type": "number"
      +          },
      +          "width": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "productDamage": {
      +      "type": "number"
      +    },
      +    "questions": {
      +      "type": "string"
      +    },
      +    "supportsComplaint": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoStatus
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photoUrl
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / photosJudged
      Added value: +{
      +  "type": "number"
      +}
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -"string"New value: +[
      +  "null",
      +  "string"
      +]
  8. Changed4 schema fields changed
    • changedInput schema / properties / classifyReviews / description
      Previous value: -"Add complaint types (delivery, quality/defect, size/fit, price/value, customer service, packaging, no effect, skin/body reaction, other), sentiment and purchase motive to each review. Reviews in other languages are classified from AliExpress' English translation. Charged per review as review-judged.\nExample values: true"New value: +"Add complaint types (delivery, quality/defect, size/fit, price/value, customer service, packaging, no effect, skin/body reaction, other), sentiment and purchase motive to each review. Reviews in other languages are classified from AliExpress' English translation. Adds $0.5 per 1,000 classified reviews on top of the $1.5 per 1,000 collection price — turn off for collection only.\nExample values: true"
    • changedInput schema / properties / reviewFilter / description
      Previous value: -"Reviews come in AliExpress' default order. Star and date sorting are not offered by the source.\nExample values: \"all\""New value: +"Reviews come in AliExpress' default order. Star and date sorting are not offered by the source. \"Only reviews from buyers in the shipping country\" uses the Shipping country under Advanced.\nExample values: \"all\""
    • changedInput schema / properties / reviewsPerProduct / description
      Previous value: -"Maximum reviews to collect for each product (charged per review). The form starts at 20 for a quick, low-cost first run; raise it up to 5,000 (default when omitted via API: 100).\nExample values: 20"New value: +"Maximum reviews to collect for each product (charged per review: $1.5 per 1,000, or $2.0 per 1,000 with AI classification). The form starts at 20 for a quick, low-cost first run; raise it up to 5,000 (default when omitted via API: 100).\nExample values: 20"
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +"string"
  9. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "additionalReview": {},
      +    "aiWritten": {
      +      "type": "boolean"
      +    },
      +    "aspects": {
      +      "items": {
      +        "properties": {
      +          "aspect": {
      +            "type": "string"
      +          },
      +          "rating": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "classifiedFrom": {
      +      "type": "string"
      +    },
      +    "complaintTypes": {
      +      "type": "string"
      +    },
      +    "country": {
      +      "type": "string"
      +    },
      +    "date": {
      +      "type": "string"
      +    },
      +    "featured": {
      +      "type": "boolean"
      +    },
      +    "hasFollowUp": {
      +      "type": "boolean"
      +    },
      +    "helpfulVotes": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "images": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "labels": {
      +      "properties": {
      +        "complaint": {
      +          "items": {
      +            "properties": {
      +              "label": {
      +                "type": "string"
      +              },
      +              "labelKo": {
      +                "type": "string"
      +              },
      +              "probability": {
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "motive": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "sentiment": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "logistics": {
      +      "type": "string"
      +    },
      +    "motive": {
      +      "type": "string"
      +    },
      +    "option": {
      +      "type": "string"
      +    },
      +    "productId": {
      +      "type": "string"
      +    },
      +    "productUrl": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "reviewId": {
      +      "type": "string"
      +    },
      +    "sentiment": {
      +      "type": "string"
      +    },
      +    "starTextMismatch": {
      +      "type": "boolean"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "textEnglish": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "type": {
      +      "type": "string"
      +    },
      +    "unhelpfulVotes": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  10. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "additionalReview": {},
      -    "aiWritten": {
      -      "type": "boolean"
      -    },
      -    "aspects": {
      -      "items": {
      -        "properties": {
      -          "aspect": {
      -            "type": "string"
      -          },
      -          "rating": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "classifiedFrom": {
      -      "type": "string"
      -    },
      -    "complaintTypes": {
      -      "type": "string"
      -    },
      -    "country": {
      -      "type": "string"
      -    },
      -    "date": {
      -      "type": "string"
      -    },
      -    "featured": {
      -      "type": "boolean"
      -    },
      -    "hasFollowUp": {
      -      "type": "boolean"
      -    },
      -    "helpfulVotes": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "images": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "labels": {
      -      "properties": {
      -        "complaint": {
      -          "items": {
      -            "properties": {
      -              "label": {
      -                "type": "string"
      -              },
      -              "labelKo": {
      -                "type": "string"
      -              },
      -              "probability": {
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "motive": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "sentiment": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "logistics": {
      -      "type": "string"
      -    },
      -    "motive": {
      -      "type": "string"
      -    },
      -    "option": {
      -      "type": "string"
      -    },
      -    "productId": {
      -      "type": "string"
      -    },
      -    "productUrl": {
      -      "type": "string"
      -    },
      -    "rating": {
      -      "type": "number"
      -    },
      -    "reviewId": {
      -      "type": "string"
      -    },
      -    "sentiment": {
      -      "type": "string"
      -    },
      -    "starTextMismatch": {
      -      "type": "boolean"
      -    },
      -    "text": {
      -      "type": "string"
      -    },
      -    "textEnglish": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "type": {
      -      "type": "string"
      -    },
      -    "unhelpfulVotes": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  11. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "additionalReview": {},
      +    "aiWritten": {
      +      "type": "boolean"
      +    },
      +    "aspects": {
      +      "items": {
      +        "properties": {
      +          "aspect": {
      +            "type": "string"
      +          },
      +          "rating": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "classifiedFrom": {
      +      "type": "string"
      +    },
      +    "complaintTypes": {
      +      "type": "string"
      +    },
      +    "country": {
      +      "type": "string"
      +    },
      +    "date": {
      +      "type": "string"
      +    },
      +    "featured": {
      +      "type": "boolean"
      +    },
      +    "hasFollowUp": {
      +      "type": "boolean"
      +    },
      +    "helpfulVotes": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "images": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "labels": {
      +      "properties": {
      +        "complaint": {
      +          "items": {
      +            "properties": {
      +              "label": {
      +                "type": "string"
      +              },
      +              "labelKo": {
      +                "type": "string"
      +              },
      +              "probability": {
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "motive": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "sentiment": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "logistics": {
      +      "type": "string"
      +    },
      +    "motive": {
      +      "type": "string"
      +    },
      +    "option": {
      +      "type": "string"
      +    },
      +    "productId": {
      +      "type": "string"
      +    },
      +    "productUrl": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "reviewId": {
      +      "type": "string"
      +    },
      +    "sentiment": {
      +      "type": "string"
      +    },
      +    "starTextMismatch": {
      +      "type": "boolean"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "textEnglish": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "type": {
      +      "type": "string"
      +    },
      +    "unhelpfulVotes": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  12. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "additionalReview": {},
      -    "aiWritten": {
      -      "type": "boolean"
      -    },
      -    "aspects": {
      -      "items": {
      -        "properties": {
      -          "aspect": {
      -            "type": "string"
      -          },
      -          "rating": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "classifiedFrom": {
      -      "type": "string"
      -    },
      -    "complaintTypes": {
      -      "type": "string"
      -    },
      -    "country": {
      -      "type": "string"
      -    },
      -    "date": {
      -      "type": "string"
      -    },
      -    "featured": {
      -      "type": "boolean"
      -    },
      -    "hasFollowUp": {
      -      "type": "boolean"
      -    },
      -    "helpfulVotes": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "images": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "labels": {
      -      "properties": {
      -        "complaint": {
      -          "items": {
      -            "properties": {
      -              "label": {
      -                "type": "string"
      -              },
      -              "labelKo": {
      -                "type": "string"
      -              },
      -              "probability": {
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "motive": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "sentiment": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "logistics": {
      -      "type": "string"
      -    },
      -    "motive": {
      -      "type": "string"
      -    },
      -    "option": {
      -      "type": "string"
      -    },
      -    "productId": {
      -      "type": "string"
      -    },
      -    "productUrl": {
      -      "type": "string"
      -    },
      -    "rating": {
      -      "type": "number"
      -    },
      -    "reviewId": {
      -      "type": "string"
      -    },
      -    "sentiment": {
      -      "type": "string"
      -    },
      -    "starTextMismatch": {
      -      "type": "boolean"
      -    },
      -    "text": {
      -      "type": "string"
      -    },
      -    "textEnglish": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "type": {
      -      "type": "string"
      -    },
      -    "unhelpfulVotes": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  13. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "additionalReview": {},
      +    "aiWritten": {
      +      "type": "boolean"
      +    },
      +    "aspects": {
      +      "items": {
      +        "properties": {
      +          "aspect": {
      +            "type": "string"
      +          },
      +          "rating": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "classifiedFrom": {
      +      "type": "string"
      +    },
      +    "complaintTypes": {
      +      "type": "string"
      +    },
      +    "country": {
      +      "type": "string"
      +    },
      +    "date": {
      +      "type": "string"
      +    },
      +    "featured": {
      +      "type": "boolean"
      +    },
      +    "hasFollowUp": {
      +      "type": "boolean"
      +    },
      +    "helpfulVotes": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "images": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "labels": {
      +      "properties": {
      +        "complaint": {
      +          "items": {
      +            "properties": {
      +              "label": {
      +                "type": "string"
      +              },
      +              "labelKo": {
      +                "type": "string"
      +              },
      +              "probability": {
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "motive": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "sentiment": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "logistics": {
      +      "type": "string"
      +    },
      +    "motive": {
      +      "type": "string"
      +    },
      +    "option": {
      +      "type": "string"
      +    },
      +    "productId": {
      +      "type": "string"
      +    },
      +    "productUrl": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "reviewId": {
      +      "type": "string"
      +    },
      +    "sentiment": {
      +      "type": "string"
      +    },
      +    "starTextMismatch": {
      +      "type": "boolean"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "textEnglish": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "type": {
      +      "type": "string"
      +    },
      +    "unhelpfulVotes": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  14. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "additionalReview": {},
      -    "aiWritten": {
      -      "type": "boolean"
      -    },
      -    "aspects": {
      -      "items": {
      -        "properties": {
      -          "aspect": {
      -            "type": "string"
      -          },
      -          "rating": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "classifiedFrom": {
      -      "type": "string"
      -    },
      -    "complaintTypes": {
      -      "type": "string"
      -    },
      -    "country": {
      -      "type": "string"
      -    },
      -    "date": {
      -      "type": "string"
      -    },
      -    "featured": {
      -      "type": "boolean"
      -    },
      -    "hasFollowUp": {
      -      "type": "boolean"
      -    },
      -    "helpfulVotes": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "images": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "labels": {
      -      "properties": {
      -        "complaint": {
      -          "items": {
      -            "properties": {
      -              "label": {
      -                "type": "string"
      -              },
      -              "labelKo": {
      -                "type": "string"
      -              },
      -              "probability": {
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "motive": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "sentiment": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "logistics": {
      -      "type": "string"
      -    },
      -    "motive": {
      -      "type": "string"
      -    },
      -    "option": {
      -      "type": "string"
      -    },
      -    "productId": {
      -      "type": "string"
      -    },
      -    "productUrl": {
      -      "type": "string"
      -    },
      -    "rating": {
      -      "type": "number"
      -    },
      -    "reviewId": {
      -      "type": "string"
      -    },
      -    "sentiment": {
      -      "type": "string"
      -    },
      -    "starTextMismatch": {
      -      "type": "boolean"
      -    },
      -    "text": {
      -      "type": "string"
      -    },
      -    "textEnglish": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "type": {
      -      "type": "string"
      -    },
      -    "unhelpfulVotes": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  15. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "additionalReview": {},
      +    "aiWritten": {
      +      "type": "boolean"
      +    },
      +    "aspects": {
      +      "items": {
      +        "properties": {
      +          "aspect": {
      +            "type": "string"
      +          },
      +          "rating": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "classifiedFrom": {
      +      "type": "string"
      +    },
      +    "complaintTypes": {
      +      "type": "string"
      +    },
      +    "country": {
      +      "type": "string"
      +    },
      +    "date": {
      +      "type": "string"
      +    },
      +    "featured": {
      +      "type": "boolean"
      +    },
      +    "hasFollowUp": {
      +      "type": "boolean"
      +    },
      +    "helpfulVotes": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "images": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "labels": {
      +      "properties": {
      +        "complaint": {
      +          "items": {
      +            "properties": {
      +              "label": {
      +                "type": "string"
      +              },
      +              "labelKo": {
      +                "type": "string"
      +              },
      +              "probability": {
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "motive": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "sentiment": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "logistics": {
      +      "type": "string"
      +    },
      +    "motive": {
      +      "type": "string"
      +    },
      +    "option": {
      +      "type": "string"
      +    },
      +    "productId": {
      +      "type": "string"
      +    },
      +    "productUrl": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "reviewId": {
      +      "type": "string"
      +    },
      +    "sentiment": {
      +      "type": "string"
      +    },
      +    "starTextMismatch": {
      +      "type": "boolean"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "textEnglish": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "type": {
      +      "type": "string"
      +    },
      +    "unhelpfulVotes": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  16. Changed2 schema fields changed
    • addedOutput schema / properties / tip / properties / caveat
      Added value: +{
      +  "description": "Present when this session cannot run the Actor the tip recommends",
      +  "type": "string"
      +}
    • changedOutput schema / properties / tip / properties / recommendedActorId / description
      Previous value: -"Apify Actor ID the tip recommends running next, when it names one — pass directly as `actor` to call-actor or fetch-actor-details"New value: +"Apify Actor ID the tip recommends, when it names one"
  17. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "additionalReview": {},
      -    "aiWritten": {
      -      "type": "boolean"
      -    },
      -    "aspects": {
      -      "items": {
      -        "properties": {
      -          "aspect": {
      -            "type": "string"
      -          },
      -          "rating": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "classifiedFrom": {
      -      "type": "string"
      -    },
      -    "complaintTypes": {
      -      "type": "string"
      -    },
      -    "country": {
      -      "type": "string"
      -    },
      -    "date": {
      -      "type": "string"
      -    },
      -    "featured": {
      -      "type": "boolean"
      -    },
      -    "hasFollowUp": {
      -      "type": "boolean"
      -    },
      -    "helpfulVotes": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "images": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "labels": {
      -      "properties": {
      -        "complaint": {
      -          "items": {
      -            "properties": {
      -              "label": {
      -                "type": "string"
      -              },
      -              "labelKo": {
      -                "type": "string"
      -              },
      -              "probability": {
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "motive": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "sentiment": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "logistics": {
      -      "type": "string"
      -    },
      -    "motive": {
      -      "type": "string"
      -    },
      -    "option": {
      -      "type": "string"
      -    },
      -    "productId": {
      -      "type": "string"
      -    },
      -    "productUrl": {
      -      "type": "string"
      -    },
      -    "rating": {
      -      "type": "number"
      -    },
      -    "reviewId": {
      -      "type": "string"
      -    },
      -    "sentiment": {
      -      "type": "string"
      -    },
      -    "starTextMismatch": {
      -      "type": "boolean"
      -    },
      -    "text": {
      -      "type": "string"
      -    },
      -    "textEnglish": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "type": {
      -      "type": "string"
      -    },
      -    "unhelpfulVotes": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  18. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "additionalReview": {},
      +    "aiWritten": {
      +      "type": "boolean"
      +    },
      +    "aspects": {
      +      "items": {
      +        "properties": {
      +          "aspect": {
      +            "type": "string"
      +          },
      +          "rating": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "classifiedFrom": {
      +      "type": "string"
      +    },
      +    "complaintTypes": {
      +      "type": "string"
      +    },
      +    "country": {
      +      "type": "string"
      +    },
      +    "date": {
      +      "type": "string"
      +    },
      +    "featured": {
      +      "type": "boolean"
      +    },
      +    "hasFollowUp": {
      +      "type": "boolean"
      +    },
      +    "helpfulVotes": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "images": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "labels": {
      +      "properties": {
      +        "complaint": {
      +          "items": {
      +            "properties": {
      +              "label": {
      +                "type": "string"
      +              },
      +              "labelKo": {
      +                "type": "string"
      +              },
      +              "probability": {
      +                "type": "number"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "motive": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "sentiment": {
      +          "properties": {
      +            "confidence": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "labelKo": {
      +              "type": "string"
      +            },
      +            "probability": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "logistics": {
      +      "type": "string"
      +    },
      +    "motive": {
      +      "type": "string"
      +    },
      +    "option": {
      +      "type": "string"
      +    },
      +    "productId": {
      +      "type": "string"
      +    },
      +    "productUrl": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "reviewId": {
      +      "type": "string"
      +    },
      +    "sentiment": {
      +      "type": "string"
      +    },
      +    "starTextMismatch": {
      +      "type": "boolean"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "textEnglish": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "type": {
      +      "type": "string"
      +    },
      +    "unhelpfulVotes": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  19. Changed8 schema fields changed
    • addedInput schema / properties / buyerCountries
      Added value: +{
      +  "default": [],
      +  "description": "Keep only reviews from buyers in these countries (two-letter codes, e.g. US, FR, BR).",
      +  "items": {
      +    "description": "Keep only reviews from buyers in these countries (two-letter codes, e.g. US, FR, BR).",
      +    "title": "Buyer countries",
      +    "type": "string"
      +  },
      +  "title": "Buyer countries",
      +  "type": "array"
      +}
    • addedInput schema / properties / customLabels
      Added value: +{
      +  "default": [],
      +  "description": "Up to 10 yes/no criteria in plain language, e.g. \"arrived broken or damaged\", \"mentions the battery\", \"looks different from the photos\". Each classified review gets a probability and `matched` per label. Included in the classification price.",
      +  "items": {
      +    "description": "Up to 10 yes/no criteria in plain language, e.g. \"arrived broken or damaged\", \"mentions the battery\", \"looks different from the photos\". Each classified review gets a probability and `matched` per label. Included in the classification price.",
      +    "title": "Custom labels",
      +    "type": "string"
      +  },
      +  "title": "Custom labels",
      +  "type": "array"
      +}
    • addedInput schema / properties / keywords
      Added value: +{
      +  "default": [],
      +  "description": "Keep only reviews whose text, English translation or follow-up contains one of these words (not case-sensitive), e.g. \"broken\", \"battery\", \"size\".",
      +  "items": {
      +    "description": "Keep only reviews whose text, English translation or follow-up contains one of these words (not case-sensitive), e.g. \"broken\", \"battery\", \"size\".",
      +    "title": "Review must mention one of",
      +    "type": "string"
      +  },
      +  "title": "Review must mention one of",
      +  "type": "array"
      +}
    • addedInput schema / properties / maxStars
      Added value: +{
      +  "description": "Keep only reviews with at most this many stars — e.g. 3 to read only the critical ones before sourcing a product.",
      +  "title": "Maximum stars",
      +  "type": "integer"
      +}
    • addedInput schema / properties / minStars
      Added value: +{
      +  "description": "Keep only reviews with at least this many stars. Leave empty for all.",
      +  "title": "Minimum stars",
      +  "type": "integer"
      +}
    • changedInput schema / properties / reviewFilter / enum
      Previous value: -[
      -  "all",
      -  "with_photos",
      -  "additional"
      -]New value: +[
      +  "all",
      +  "with_photos",
      +  "additional",
      +  "local"
      +]
    • addedInput schema / properties / reviewsNewerThan
      Added value: +{
      +  "description": "A date (`2026-09-01`) or a period (`30 days`, `6 months`).",
      +  "title": "Only reviews newer than",
      +  "type": "string"
      +}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "additionalReview": {},
      -    "aspects": {
      -      "items": {
      -        "properties": {
      -          "aspect": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "classifiedFrom": {
      -      "type": "string"
      -    },
      -    "country": {
      -      "type": "string"
      -    },
      -    "date": {
      -      "type": "string"
      -    },
      -    "helpfulVotes": {
      -      "type": "number"
      -    },
      -    "images": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "labels": {
      -      "properties": {
      -        "complaint": {
      -          "items": {
      -            "properties": {
      -              "label": {
      -                "type": "string"
      -              },
      -              "labelKo": {
      -                "type": "string"
      -              },
      -              "probability": {
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "motive": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "sentiment": {
      -          "properties": {
      -            "confidence": {
      -              "type": "number"
      -            },
      -            "label": {
      -              "type": "string"
      -            },
      -            "labelKo": {
      -              "type": "string"
      -            },
      -            "probability": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "logistics": {
      -      "type": "string"
      -    },
      -    "option": {
      -      "type": "string"
      -    },
      -    "productId": {
      -      "type": "string"
      -    },
      -    "productUrl": {
      -      "type": "string"
      -    },
      -    "rating": {
      -      "type": "number"
      -    },
      -    "reviewId": {
      -      "type": "string"
      -    },
      -    "text": {
      -      "type": "string"
      -    },
      -    "textEnglish": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "type": {
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
  20. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  21. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  22. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  23. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  24. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  25. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  26. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  27. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  28. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  29. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  30. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  31. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  32. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  33. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  34. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  35. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  36. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  37. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  38. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  39. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  40. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  41. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  42. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  43. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  44. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  45. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  46. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  47. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  48. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  49. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  50. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  51. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  52. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  53. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  54. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  55. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  56. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  57. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  58. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  59. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  60. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  61. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  62. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  63. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  64. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  65. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  66. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  67. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  68. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  69. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  70. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  71. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  72. Changed1 schema field changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / textEnglish / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  73. First observed

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare readOnlyHint=false, destructiveHint=true and openWorldHint=true, but give no cost or latency signal; the description supplies both ('~8 min/1,000 reviews, pay per review') plus 'No login', which are the traits an agent most needs to decide whether to invoke. It does not explain what the destructive hint means here (a scrape writes nothing user-visible) or how partial runs behave at the wait cap, though the schema's waitSecs paragraph covers the latter.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Very short and front-loaded with the routing rule and cost model, which is the right ordering. The opening sentence ('This tool calls the Actor ... and retrieves its output results') is generic wrapper boilerplate that adds no decision value, and the trailing fragments ('productUrls or IDs.') read as notes rather than prose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 22-parameter actor wrapper with an output schema and full annotation coverage, the description supplies the essentials an agent needs before calling: what it returns conceptually, which input type it targets, the sibling to use instead, auth requirements, runtime and pricing. Per-parameter behavior is fully documented in the schema, and return shape is covered by the output schema, so nothing critical is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% across 22 parameters, with rich per-parameter text for filters, cost toggles (classifyReviews, reviewsPerProduct) and proxy settings, so the schema carries the semantics. The description adds only a thin hint that product URLs or bare IDs are accepted. Baseline 3 applies when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('calls the Actor leoworks/aliexpress-reviews-classifier and retrieves its output results') and the actor description adds concrete scope: review scraping with translation, stars, country, photos, complaint and sentiment analysis. It explicitly separates itself from leoworks/aliexpress-search-scraper by input type (known products vs keyword search). Slightly degraded by the wrapper boilerplate in the first sentence and telegraphic fragments like 'productUrls or IDs.'

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Use for known products; for keyword search use leoworks/aliexpress-search-scraper' is an explicit routing rule naming the alternative and the condition that selects it. It adds practical context (no login required, ~8 min per 1,000 reviews, pay per review) that helps decide whether to run it. No explicit when-not guidance beyond the keyword case, e.g. when budget or time caps make it unsuitable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.