Dealer API & Integrations
Push your stock to AYIO Marketplace from your DMS, website, or spreadsheet. RESTful JSON API, owner-scoped keys, free moderation, no commission.
Bulk inventory sync
Push your entire inventory in one job. Listings land in our moderation queue and go live the same day during business hours.
Webhooks (HMAC-signed)
Get notified the moment a listing is approved, rejected, or receives a buyer message — auto-retried with backoff, signed with your secret.
Stats endpoint
Pull 30-day views, messages, offers, and your top listings — straight into your DMS dashboard.
Live updates
Update price, status (active/sold/expired), or vehicle details. Mark sold the second it's gone — no stale ads.
Owner-scoped keys
Each key is bound to your seller account. You can only edit your own listings — no risk of cross-dealer interference.
Endpoints
Base URL: https://marketplace.ayiojobs.com.au/api/v1
| Method | Endpoint | What it does |
|---|---|---|
| GET | /categories.php |
Fetch valid categories + enum reference for client validation |
| GET | /listings.php |
Browse listings. Filter: ?category=trucks&state=NSW&make=Isuzu&mine=1 |
| POST | /listings.php |
Create a listing. JSON body. Returns 201 with id + slug — lands in pending moderation. |
| GET | /listing.php?id=LST_… |
Fetch full detail incl. images |
| PATCH | /listing.php?id=LST_… |
Update title, description, price, price_type, status, or vehicle fields |
| DELETE | /listing.php?id=LST_… |
Withdraw the listing (soft-delete, reversible by AYIO admin) |
| POST | /images.php?listing_id=LST_… |
Upload an image (multipart) OR fetch by URL. JPEG/PNG/WebP, 5 MB max, 10 per listing. |
Quickstart — create a listing in one curl
Replace AM_xxx with the key we'll send you.
curl -X POST https://marketplace.ayiojobs.com.au/api/v1/listings.php \ -H "X-API-Key: AM_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "title": "2018 Isuzu NPR 75 Tipper", "description": "240,000km, full service history, 6mo rego.", "category": "trucks", "make": "Isuzu", "model": "NPR 75", "year": 2018, "price": 85000, "price_type": "negotiable", "gst_status": "inc_gst", "state": "NSW", "suburb": "Parramatta", "odometer": 240000, "transmission": "Manual", "fuel_type": "Diesel", "vin": "JNLAFR82VK1234567" }' # Response (201 Created): { "success": true, "data": { "id": "LST_abc123def456", "slug": "2018-isuzu-npr-75-tipper", "status": "active", "moderation_status": "pending", "public_url": "https://marketplace.ayiojobs.com.au/listing/2018-isuzu-npr-75-tipper", "images_url": "https://marketplace.ayiojobs.com.au/api/v1/images.php?listing_id=LST_abc123def456" } }
Frequently asked
- How much does it cost?
- Free at launch. AYIO is an advertising platform — we charge listing fees for premium placements (configurable by you), but the API itself is free for verified dealers.
- Do you charge commission?
- No. We're not brokers. AYIO is an ASIC-compliant advertising platform — buyer and seller transact directly.
- How long until listings go live?
- Listings created via the API land in our moderation queue. We approve same-day during business hours (AEST). You'll see the listing as
moderation_status: "pending"until then. - What about images?
- Up to 10 per listing. Either upload directly (multipart) or send us an HTTPS URL and we'll fetch it (with SSRF protection — we don't fetch private/reserved IPs).
- What's the rate limit?
- Default 100 successful calls/hour and 500/day per key. Higher limits available on request — tell us your volume in the form below.
- How do I get a key?
- Fill in the form below. We'll verify your business via ABN lookup and email a key within one business day.
- What about webhooks?
- Coming after launch. v1 is poll-based: hit
GET /listings.php?mine=1to see your inventory state. Webhook subscriptions are roadmapped for Q3 2026.
Request an API key
Tell us about your business and what you want to integrate. We'll email you a key within one business day.