Skip to main content

​
Endpoint

POST /loopos_ai_c2c_descriptor Analyzes item photos, description, and metadata to generate marketplace listing details.

​
Request

​
language
string
default:"PT-PT"
Language code for the request (e.g., “PT-PT”, “en-US”)
​
images
array
required
List of image URLs or base64 data URLs of the item
​
agent_specific
object
required
Service-specific parameters:
  • category_name (string): Human readable category
  • product_name (string): Product name/model
  • brand_name (string): Brand name
  • user_description (string): Seller’s description
  • condition (string, optional): Condition hint (A, B, C, D)
  • value_out_max (number, optional): Upper price hint
  • value_out_min (number, optional): Lower price hint
  • value_out_average (number, optional): Average price hint
​
loopos_core_context
string
Business context or additional information for the AI agent
​
session_extra_data
object
Additional session metadata

​
Response

​
value_out_max
number
required
Maximum estimated selling price on second-hand platform
​
value_out_min
number
required
Minimum estimated selling price on second-hand platform
​
value_out_average
number
required
Average estimated selling price on second-hand platform
​
marketplace_posting_title
string
required
Generated title for the marketplace posting
​
marketplace_posting_description
string
required
Generated description of the item in its current condition
​
condition
string
required
Item condition: A (Excellent), B (Good), C (Fair), D (Poor)
​
dimensions_box
string
required
Box size: S (Small), L (Large, >30kg or >1.5m in any dimension)
​
warning
boolean
required
True if inconsistencies detected between photos, description, category, brand, or product
​
warning_message
string
required
Warning message explaining inconsistencies and how to fix them

​
Example Request

{
  "language": "PT-PT",
  "images": ["https://example.com/image.jpg"],
  "agent_specific": {
    "category_name": "Electronics",
    "product_name": "iPhone 12 Pro",
    "brand_name": "Apple",
    "user_description": "iPhone em excelente estado"
  }
}

​
Example Response

{
  "value_out_max": 500.0,
  "value_out_min": 350.0,
  "value_out_average": 425.0,
  "marketplace_posting_title": "iPhone 12 Pro - Excelente Estado",
  "marketplace_posting_description": "iPhone 12 Pro em excelente estado...",
  "condition": "B",
  "dimensions_box": "S",
  "warning": false,
  "warning_message": ""
}