← All Friday Seller Tools

Pay once · No Friday subscription

Marketplace Category / Node Suggester

Rank current category candidates against the product facts you trust.

Amazon USWalmart USShopifyeBay US

Included in the $9.00 Shelf Kit

Agent/API — $0.25
Review-first
Every output stays a draft.
No credentials
No seller-account login required.
Private delivery
Inputs expire after 24 hours.
Clear recourse
Digital-service refund policy.

What you receive

  • One to five ranked seller-supplied category candidates
  • Transparent 0–100 text-match score for each
  • Matched terms and exact product-fact evidence fields
  • Unmatched candidate terms and plain-language rationale
  • Ambiguity warning and taxonomy search phrases

Who it is for

Sellers, agencies, and agents narrowing a current marketplace category shortlist before manual eligibility and attribute review.

Delivery: usually a structured result, workbook, or ZIP depending on the tool.

How it stays safe

Friday ranks only the candidate IDs, paths, labels, and keywords you supply; it does not fetch or verify a current taxonomy. Text overlap does not establish category eligibility, browse placement, required attributes, fees, approval, or policy compliance. It does not publish listings, access a seller account, or select, change, or upload a category.

Synthetic sample

See the deliverable structure before buying

{
  "marketplace": "amazon_us",
  "suggestions": [
    {
      "rank": 1,
      "node_id": "hyd-100",
      "label": "Insulated Water Bottles",
      "path": "Sports & Outdoors > Hydration > Water Bottles",
      "match_score": 58.8,
      "matched_terms": [
        "bottle",
        "insulated",
        "reusable",
        "vacuum",
        "water"
      ],
      "evidence_fields": [
        "category",
        "product_name",
        "keywords",
        "features"
      ],
      "unmatched_candidate_terms": [
        "hydration",
        "outdoor",
        "sport"
      ],
      "rationale": "Matched 5 of 8 normalized candidate terms across 4 supplied product-fact field(s)."
    },
    {
      "rank": 2,
      "node_id": "access-300",
      "label": "Bottle Accessories",
      "path": "Sports & Outdoors > Hydration > Bottle Accessories",
      "match_score": 26.7,
      "matched_terms": [
        "bottle",
        "lid"
      ],
      "evidence_fields": [
        "category",
        "product_name",
        "keywords",
        "features"
      ],
      "unmatched_candidate_terms": [
        "accessory",
        "hydration",
        "outdoor",
        "replacement",
        "sleeve",
        "sport"
      ],
      "rationale": "Matched 2 of 8 normalized candidate terms across 4 supplied product-fact field(s)."
    },
    {
      "rank": 3,
      "node_id": "drink-200",
      "label": "Travel Mugs",
      "path": "Home & Kitchen > Drinkware > Travel Mugs",
      "match_score": 10.1,
      "matched_terms": [
        "commuter"
      ],
      "evidence_fields": [
        "target_audience"
      ],
      "unmatched_candidate_terms": [
        "coffee",
        "cup",
        "drinkware",
        "home",
        "kitchen",
        "mug",
        "travel"
      ],
      "rationale": "Matched 1 of 8 normalized candidate terms across 1 supplied product-fact field(s)."
    }
  ],
  "suggested_search_phrases": [
    "water bottles",
    "Insulated Stainless Steel Water Bottle",
    "stainless steel water bottles"
  ],
  "ambiguous": false,
  "warnings": [
    "Candidate IDs, labels, paths, and keywords are seller-supplied; Friday does not fetch or verify a current marketplace taxonomy.",
    "A high text match does not establish category eligibility, browse placement, required attributes, fees, approval, or policy compliance.",
    "No seller account was accessed and no category or listing was changed or published."
  ],
  "method_notes": [
    "Scores use normalized word overlap between each supplied candidate and the supplied category, product name, keywords, features, materials, benefits, and audience.",
    "Category and product-name evidence receive the highest deterministic weights; ties are resolved by candidate node ID for stable output.",
    "The transform does not use sales, traffic, conversion, search-volume, browse-tree, or marketplace-account data."
  ],
  "publish_status": "draft_needs_review"
}

This sample uses synthetic facts. Your output is generated only from the facts you submit.

Agent API and x402 details

POST /v1/catalog/category-node-suggestions

Exact x402 price: $0.25. Use the public OpenAPI schema and Base USDC payment flow. The response returns a private job URL and temporary token.

Open the API documentation →

Related seller tools