AuctionsNearMe Sync API

Already have your own auction site? No problem. You can securely connect and share your listings with a global audience. Our API allows approved platforms to sync live auctions directly to AuctionsNearMe.com, where they’ll appear on our 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

{
  "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",
      "category": "Real Estate"
    }
  ]
}

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

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

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

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",
    "category": "Real Estate"
  }
]

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

📂 Categories

The category field is optional, but strongly recommended to ensure your listings show up in relevant filters on AuctionsNearMe.com.

Accepted values for category:

• Vehicles & Transportation
• Real Estate
• Art & Collectibles
• Jewelry & Watches
• Fashion & Accessories
• Electronics & Gadgets
• Home & Garden
• Appliances
• Baby & Kids
• Health & Beauty
• Sports & Outdoors
• Business & Industrial
• Livestock & Agriculture
• Computers & Software
• Books, Movies & Media
• Services
• Other

Note: These are case-sensitive. Please use the exact spelling as listed above.

✅ 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",
    "category": "Real Estate"
  }
]

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