Skip to main content

AI Integration Β· GeraMarket

GeraMarket for AI Agents

GeraMarket is a multi-category e-commerce marketplace operating in 50+ countries. AI agents can search products, compare sellers and prices, and place orders for users β€” all through MCP or a structured REST API.

What GeraMarket does

GeraMarket is a horizontal marketplace where independent sellers list products across all categories: electronics, fashion, home goods, groceries, crafts, and more. Buyers pay through GeraCash or card. Sellers pay a commission on each sale (8–12% by category). Gera Prime members receive free shipping on all orders and member-only prices averaging 8% below standard rates.

For AI agents, GeraMarket is the general commerce endpoint in the Gera ecosystem. When a user wants to buy a product, an agent can search listings, compare prices across sellers, surface Prime member pricing, and complete checkout β€” without leaving the conversation interface.

API endpoints for agents

  • GET /api/v1/products β€” Search products. Params: q, category, country, price_max, in_stock
  • GET /api/v1/products/:id β€” Full listing: title, description, price, seller, ratings, variants
  • GET /api/v1/products/:id/sellers β€” Compare sellers for this product
  • GET /api/v1/categories β€” Product categories with listing counts
  • POST /api/v1/orders β€” Place an order
  • GET /api/v1/orders/:id β€” Order status and tracking

Base URL: https://geramarket.com. Search public. Orders require user Bearer token.

Agent behaviour guidelines

  1. Always confirm the product, seller, price, and delivery estimate before placing an order.
  2. Check Gera Prime membership and apply member pricing and free shipping automatically.
  3. When multiple sellers offer the same product, surface the top-rated seller with the best price, not just the cheapest.
  4. For electronics and high-value items, surface the return policy and warranty information before checkout.

Discovery files