Skip to main content

​
Endpoint

POST /loopos_ai_c2c_validation Automatically routes to appropriate validation agent based on input:
  • Title/Description Validation: When marketplace_posting_title or marketplace_posting_description provided
  • Brand Validation: When brand_name provided
  • Product Validation: When product_name provided

​
Request

​
language
string
default:"PT-PT"
Language code for the request
​
images
array
List of image URLs or base64 data URLs
​
agent_specific
object
required
Service-specific parameters. Include fields based on validation type:For Title/Description Validation:
  • marketplace_posting_title (string): Listing title to validate
  • marketplace_posting_description (string): Listing description to validate
  • category_name (string): Category name
For Brand Validation:
  • brand_name (string): Brand name to validate
  • reference_brands (string, optional): CSV with catalog brands (id + name)
For Product Validation:
  • product_name (string): Product name to validate
  • reference_products (string, optional): CSV with catalog products (id + name)
​
loopos_core_context
string
Business context for the AI agent

​
Response

The response structure varies based on validation type:

​
Title/Description Validation Response

​
approved
boolean
required
True if auto-approved; false if changes are required
​
rejection_reason
string
Primary reason when not approved
​
confidence_score
number
Confidence in the decision (0-1)
​
validation_notes
string
Detailed reason and guidance
​
required_modifications
array
Precise edits needed for approval
​
message_to_user
string
Short, actionable summary for the seller (≤200 chars, PT-PT)

​
Brand Validation Response

​
new_brand
boolean
required
False if brand exists; true if not found
​
new_brand_name
string
Normalized name if it’s new
​
existing_brand_name
string
Original name if it exists
​
existing_brand_id
integer
Catalog ID if it exists

​
Product Validation Response

​
new_product
boolean
required
False if product exists; true if not found
​
new_product_name
string
Normalized name if it’s new
​
existing_product_name
string
Original name if it exists
​
existing_product_id
integer
Catalog ID if it exists

​
Example Request (Title/Description)

{
  "language": "PT-PT",
  "images": ["https://example.com/image.jpg"],
  "agent_specific": {
    "marketplace_posting_title": "iPhone 12 Pro - Excelente Estado",
    "marketplace_posting_description": "iPhone em excelente estado...",
    "category_name": "Electronics"
  }
}

​
Example Response (Title/Description)

{
  "approved": true,
  "rejection_reason": null,
  "confidence_score": 0.95,
  "validation_notes": "Listing meets all quality standards...",
  "required_modifications": [],
  "message_to_user": "O seu anúncio foi aprovado!"
}