Skip to main content

​
Endpoint

POST /loopos_ai_value_estimation Uses web search to research current prices on Portuguese marketplaces (OLX, Custojusto, etc.) and calculates recycling values and repair costs.

​
Request

​
language
string
default:"PT-PT"
Language code for the request
​
agent_specific
object
required
Service-specific parameters:
  • loopos_item (object): Item information for estimation, containing:
    • name (string): Item name
    • brand (string): Brand name
    • condition (string): Condition (A, B, C, D)
    • description (string): Item description
    • category (string): Category name
​
loopos_core_context
string
Business context 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
​
recycling_value_max
number
required
Maximum estimated recycling revenue
​
recycling_value_min
number
required
Minimum estimated recycling revenue
​
recycling_value_average
number
required
Average estimated recycling revenue
​
repair_cost_max
number
required
Maximum estimated repair cost
​
repair_cost_min
number
required
Minimum estimated repair cost
​
repair_cost_average
number
required
Average estimated repair cost
​
reasoning
string
required
Explanation of the value estimation process
​
description
string
required
Description of the item in its current condition
​
references
array
required
List of 2-10 reference sources used for price estimation

​
Example Request

{
  "language": "PT-PT",
  "agent_specific": {
    "loopos_item": {
      "name": "iPhone 12",
      "brand": "Apple",
      "condition": "B",
      "description": "iPhone 12 em bom estado, 128GB, cor azul",
      "category": "Smartphones"
    }
  },
  "loopos_core_context": "Circular economy platform"
}

​
Example Response

{
  "value_out_max": 500.0,
  "value_out_min": 350.0,
  "value_out_average": 425.0,
  "recycling_value_max": 50.0,
  "recycling_value_min": 30.0,
  "recycling_value_average": 40.0,
  "repair_cost_max": 100.0,
  "repair_cost_min": 50.0,
  "repair_cost_average": 75.0,
  "reasoning": "Based on web search results...",
  "description": "iPhone 12 em bom estado...",
  "references": ["https://example.com/market-research"]
}