Agent Infrastructure Co

Agent-native commerce

# Agent Commerce API

Ready for third-party sandbox testing. Normalized marketplace evidence for agents buying, selling, comparing, or validating used goods. The API gives agents provider/snapshot evidence, provenance, deal checks, and seller handoffs without claiming to own inventory or run checkout.

[ /activate ][ /docs ][ /openapi.json ]

## Search

POST /api/v1/goods/search returns normalized eBay Browse API listing evidence where configured and authorized Craigslist snapshots where available.

## Deal validation

POST /api/v1/goods/deal/validate compares a target listing against eligible comps, excludes the target from its own comps, and returns risk and seller-handoff fields.

## Branchable outputs

provider_statuses with eBay Browse API or authorized Craigslist snapshot provenance

normalized listing ids, URLs, prices, shipping, condition hints, and freshness

goods.deal.validate / POST /api/v1/goods/deal/validate returns deal_validation, price_vs_market, scam_risk_signals, missing_checks, seller_questions, and seller_handoff

seller_handoff message templates an agent can pass to the marketplace or human operator

## Search quickstart

export AICO_COMMERCE_KEY="paste-key-here"

curl https://agentinfrastructureco.com/api/v1/goods/search \
  -H "$(printf '%s %s' 'Authorization:' "Bearer $AICO_COMMERCE_KEY")" \
  -H "Content-Type: application/json" \
  -d '{
    "item_query": "Herman Miller Aeron Size B",
    "providers": ["ebay", "craigslist"],
    "location": "sfbay",
    "min_price_usd": 200,
    "max_price_usd": 800,
    "must_have": ["Aeron"],
    "avoid": ["broken", "parts only"]
  }'

## Deal-validation quickstart

curl https://agentinfrastructureco.com/api/v1/goods/deal/validate \
  -H "$(printf '%s %s' 'Authorization:' "Bearer $AICO_COMMERCE_KEY")" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Herman Miller Aeron Size B chair",
    "listing_url": "https://sfbay.craigslist.org/sfc/fuo/d/aeron/111.html",
    "price_usd": 350,
    "location": "sfbay",
    "providers": ["craigslist"]
  }'

## Truth boundaries

availability_guaranteed: false
seller_identity_verified_by_aico: false
aico_checkout_supported: false
aico_escrow_supported: false