Available · v1

Listing Intelligence

Send a product listing with your requirements, marketplace rules, and verified product facts. Get back structured issues, missing attributes, and actionable improvements before the listing goes live.

  • Your requirements are checked exactly in code
  • Contradictions and unsupported claims are flagged against your facts
  • Marketplace rules are quoted back word for word
  • Never rewrites copy or invents specifications
Try it in the playgroundAPI reference
Request body
{
  "listing": {
    "title": "Acme TrailRunner Wireless Earbuds, Black",
    "description": "Lightweight wireless earbuds with active noise cancellation and up to 8 hours of playback per charge. The best earbuds ever made, guaranteed to never fail.",
    "category": "Headphones",
    "attributes": {
      "color": "Black",
      "battery_life": "8 hours",
      "connectivity": "Bluetooth 5.3"
    }
  },
  "requirements": {
    "required_attributes": [
      "color",
      "connectivity",
      "warranty"
    ],
    "title_max_length": 80
  },
  "facts": {
    "battery_life": "8 hours",
    "connectivity": "Bluetooth 5.3"
  }
}
Response · 200 OK
{
  "request_id": "req_Vk2pT9rQw4NbL8yH",
  "status": "improvements_needed",
  "recommended_action": "revise",
  "issues": [
    {
      "type": "missing_information",
      "method": "deterministic",
      "field": "listing.attributes.warranty",
      "explanation": "A required attribute is missing.",
      "evidence": [
        "requirements.required_attributes"
      ]
    },
    {
      "type": "unsupported_claim",
      "method": "model_assisted",
      "field": "listing.description",
      "explanation": "The description makes a claim that the supplied facts and attributes don't support.",
      "evidence": [
        "listing.description"
      ]
    }
  ],
  "missing_attributes": [
    "warranty"
  ],
  "suggested_improvements": [
    "Add the warranty attribute.",
    "Remove claims you can't support, or supply the facts that support them."
  ]
}
The problem

Valid listings can still be wrong

A listing can pass schema validation while its title says 256GB and its attributes say 128GB, or its description promises results nobody can back up. Bad listings cause returns, complaints, and policy violations.

Requirement checks
Required attributes, allowed categories, length limits, prohibited terms, and identifier check digits are checked deterministically.
Consistency and claims
Title, description, attributes, and your verified facts are compared for contradictions and unsupported claims.
Marketplace rules
Each rule in your policy is evaluated separately, with uncertain cases sent for review instead of guessed.
Use cases

Where teams use it

  • Marketplace listing review
  • Seller onboarding
  • Catalog quality
  • Product data syndication
  • Retail media
Integrate

One HTTP call

const response = await fetch("https://kovca.io/api/v1/listings/check", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KOVCA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "listing": {
      "title": "Acme TrailRunner Wireless Earbuds, Black",
      "description": "Lightweight wireless earbuds with active noise cancellation and up to 8 hours of playback per charge. The best earbuds ever made, guaranteed to never fail.",
      "category": "Headphones",
      "attributes": {
        "color": "Black",
        "battery_life": "8 hours",
        "connectivity": "Bluetooth 5.3"
      }
    },
    "requirements": {
      "required_attributes": [
        "color",
        "connectivity",
        "warranty"
      ],
      "title_max_length": 80
    },
    "facts": {
      "battery_life": "8 hours",
      "connectivity": "Bluetooth 5.3"
    }
  }),
});

if (!response.ok) {
  const { error, request_id } = await response.json();
  throw new Error(`${error.code}: ${error.message} (${request_id})`);
}

const { status, recommended_action, issues } = await response.json();

Related APIs

  • Returns Intelligence

    Classify return requests, check them against your return policy, and get a suggested next step.

  • Catalog Matching

    Decide whether two product records are the same item, a different variant, or a different product.

  • Compatibility Intelligence

    Determine whether two products work together using structured specifications, compatibility rules, and intelligent evaluation.

  • Warranty Intelligence

    Classify warranty claims, check them against the warranty terms you supply, and get the next workflow step.