Big OLX for developers

Public REST API + MCP server. Reads are open, writes need a Bearer token from your cabinet. Machine-readable spec: https://exgo.io/api/openapi.json

Search listings

curl "https://exgo.io/api/v1/listings?q=iphone&city=kyiv&category=telefony"

Get one listing

curl "https://exgo.io/api/v1/listings/{id-or-slug}"

Categories & attributes

curl "https://exgo.io/api/v1/categories"

Create a listing

curl -X POST "https://exgo.io/api/v1/listings" \
  -H "Authorization: Bearer bx_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "iPhone 13 128GB",
    "description": "Great condition, full kit, battery 89%.",
    "price": 15500, "currency": "UAH",
    "categoryId": 11, "city": "kyiv",
    "attributes": { "condition": "used" },
    "photos": ["https://example.com/photo.jpg"]
  }'

New sellers’ listings go to moderation (status PENDING); sellers with 3+ approved listings publish instantly.

Update your listing

curl -X PATCH "https://exgo.io/api/v1/listings/{id-or-slug}" \
  -H "Authorization: Bearer bx_..." \
  -H "Content-Type: application/json" \
  -d '{ "price": 14900, "attributes": { "condition": "used" } }'

Partial update: only sent fields change; "price": null clears the price. Editing a visible listing sends it back to moderation (PENDING). Only the token owner’s own listings — 403 otherwise, 409 for archived ones.

Delete your listing

curl -X DELETE "https://exgo.io/api/v1/listings/{id-or-slug}" \
  -H "Authorization: Bearer bx_..."

MCP server (AI agents)

The repo ships an MCP server (mcp/) exposing search_listings, get_listing, list_categories, create_listing, update_listing, delete_listing. Add to any MCP client:

{
  "mcpServers": {
    "bigolx": {
      "command": "node",
      "args": ["mcp/server.mjs"],
      "env": {
        "BIGOLX_URL": "https://exgo.io",
        "BIGOLX_API_TOKEN": "bx_..."
      }
    }
  }
}