API Management & Integration

Access application insights and features programmatically using our APIs. These APIs rely on a canonical data source configured via environment variables.

AI Tools APIs

Leverage our AI-powered tools for pricing and communication.

AI Pricing Assistant API

Live

Provides AI-driven price suggestions, price ranges, and rationales for items.

Endpoint:

POST /api/pricing

Request Body:

{
  "title": "Vintage Wooden Chair, Large",
  "category": "Furniture",
  "type": "Chair",
  "priceForSimilarity": 25000
}

Example Response (200 OK):

{
  "suggestedPrice": 22000,
  "priceRange": {
    "minPrice": 18000,
    "maxPrice": 26000
  },
  "rationale": "The item is a 'Vintage Wooden Chair, Large'. Considering similar...",
  "detectedCategory": "Furniture",
  "detectedType": "Chair"
}

Full Documentation:

For more details, see the AI Pricing API Documentation.

Market Data & Insights APIs

The following APIs provide programmatic access to the marketplace data and aggregated insights.

Raw Market Data API

Live

Access the full list of market items, with support for pagination, search, filtering, and sorting.

Endpoint:

GET /api/market-items

Query Parameters:

page, limit (for pagination, default is page=1, limit=12)
search (for text search)
category, type, platform (for filtering)
sortBy, sortOrder (for sorting, e.g., sortBy=price&sortOrder=desc)

Example Response:

{
  "totalItems": 12,
  "totalPages": 1,
  "currentPage": 1,
  "items": [
    {
      "id": "1",
      "title": "Vintage Armchair",
      "category": "Furniture",
      "type": "Chair",
      "price": 120000,
      "platform": "Facebook Marketplace",
      "listedDate": "2023-10-01T10:00:00Z",
      "condition": "Used - Good",
      "location": "Lagos",
      "imageUrl": "https://placehold.co/600x400.png",
      "dataAiHint": "armchair vintage"
    }
  ]
}

Aggregated Price Summaries API

Live

Get the lowest and highest priced items per category.

Endpoint:

GET /api/price-summaries

Query Parameters:

categories (e.g., categories=Electronics,Furniture). If omitted, all categories are returned.

Example Response:

[
  {
    "category": "Furniture",
    "lowestPriceItem": { /* MarketItem object */ },
    "highestPriceItem": { /* MarketItem object */ }
  },
  // ... more summaries
]

Aggregated Chart/Statistics APIs

Live

Access data used to generate dashboard charts.

Endpoints:

GET /api/stats/items-by-category
GET /api/stats/price-distribution
GET /api/stats/items-by-platform
GET /api/stats/items-over-time

Example Response (for items-by-category):

[
  { "category": "Electronics", "count": 25 },
  { "category": "Furniture", "count": 40 }
]