AuctionsNearMe Sync API

This API allows approved auction platforms to sync their live auction listings to AuctionsNearMe.com, where listings are shown on an interactive globe.

🛠️ Getting Your Key

Ready to get your auctions on the map? Email support@auctionsnearme.com for access details.

🔐 Authentication

You will be assigned a unique secret_key. You do not need to handle encryption yourself—AuctionsNearMe will provide an encrypted key to use in your requests.

📤 Sync Endpoint

POST https://auctionsnearme.com/api/sync_auction.php

JSON Payload Example

Important: You must include the active_ids array in your request. This should be a list of all unique_id values that are currently active on your platform. Any listings not included in this list will be removed from AuctionsNearMe automatically.

{
  "key": "ENCRYPTED_API_KEY_PROVIDED_TO_YOU",
  "active_ids": ["9d6e0adb483fe9da"],
  "auctions": [
    {
      "unique_id": "9d6e0adb483fe9da",
      "title": "Vintage Guitar Auction",
      "description": "A rare 1960s Fender Strat...",
      "address": "Austin, TX",
      "latitude": 30.2672,
      "longitude": -97.7431,
      "listing_url": "https://clientsite.com/forward_auction.php?id=9d6e0adb483fe9da",
      "type": "forward",
      "start_time": "2025-05-10 15:00:00",
      "end_time": "2025-05-12 15:00:00",
      "image_path": "https://clientsite.com/uploads/auctions/123.jpg",
      "timezone": "America/Chicago"
    }
  ]
}

Required fields: unique_id, title, listing_url, start_time, end_time

Optional fields: description, address, latitude, longitude, type

Recommended: image_path, timezone – ensures proper time display in listings

✅ Success Response

Successfully synced X auctions.

❌ Error Responses

• 403 Invalid API key – Decryption failed or key not recognized
• 400 Invalid data structure – Missing or malformed auctions array

🧭 Internal & Display Endpoint

Note: This endpoint is used internally by AuctionsNearMe.com to power the interactive globe. Do not use it to submit listings.

GET https://auctionsnearme.com/api/get_live_auctions.php

Example Response:

[
  {
    "title": "Vintage Guitar Auction",
    "listing_url": "https://clientsite.com/forward_auction.php?id=9d6e0adb483fe9da",
    "address": "Austin, TX",
    "latitude": 30.2672,
    "longitude": -97.7431,
    "auction_type": "forward",
    "end_time": "2025-05-12 15:00:00",
    "timezone": "America/Chicago",
    "description": "A rare 1960s Fender Strat...",
    "image_path": "https://clientsite.com/uploads/auctions/123.jpg"
  }
]

Need help integrating? Email us at support@auctionsnearme.com.