API pour développeurs

Bateaux accidentés, motomarines et HIN, en JSON

Chaque bateau et motomarine de Copart et IAA aux États-Unis et au Canada, à venir et vendus avec la dernière offre, plus un décodeur HIN. Du REST simple, une clé, payé en crédits SalvageAlert.

Créer un compte gratuit : 50 crédits Démarrage rapide

50 crédits gratuits: avec un compte gratuit
60+ requêtes/min: plus avec les forfaits payants
OpenAPI 3: pour Postman et les générateurs de SDK

Démarrage rapide

1
Créer un compte gratuit
C’est un compte SalvageAlert, et il vient avec 50 crédits API.
2
Créer une clé
Dans votre compte, sous API. Copiez-la : elle n’est affichée qu’une fois.
3
Faire un appel
Envoyez-la comme jeton Bearer. Chaque appel indique son coût et ce qu’il reste.

curl "https://salvagealert.com/api/v1/boats?status=live&kind=pwc&sort=ending&per_page=10" \
  -H "Authorization: Bearer $SA_API_KEY"

Authentification

Chaque requête transporte votre clé dans l’en-tête Authorization. Les clés commencent par sa_live_, fonctionnent sur les points d’accès de boat.vin et sur tous ceux de SalvageAlert, et se révoquent à tout moment depuis votre compte. Gardez-les sur votre serveur : jamais dans une page Web ni dans une application.

URL de base

https://salvagealert.com/api/v1

En-tête

Authorization: Bearer sa_live_…

Crédits et limites

Les appels sont payés en crédits API SalvageAlert, le même solde que l’API autos. Un compte boat.vin gratuit commence avec 50 crédits. Les forfaits payants de SalvageAlert en ajoutent 500 ou 5 000 par mois, et les paquets de crédits rechargent n’importe quel compte. Les erreurs ne sont jamais facturées.

Point d’accès	Coût
GET /boats	1 crédit par page
GET /boats/{source}/{lot_key}	1 crédit
GET /boats/hin/{hin}	1 crédit
GET /boats/makes	Gratuit

Chaque réponse porte x-credits-charged, x-credits-balance, x-ratelimit-limit, x-ratelimit-remaining et x-request-id. Le forfait gratuit permet 60 requêtes par minute.

Acheter des crédits

1 crédit par page

GET`/boats`

Chercher des bateaux et motomarines, à venir et vendus, avec tous les filtres de boat.vin.

Paramètre	Valeurs	Ce qu’il fait
status	live · ended · all	Les enchères à venir et en cours, les archives des ventes, ou les deux (par défaut).
kind	boat · pwc	Bateaux, ou motomarines et véhicules nautiques personnels.
q	text	Texte libre : marque, modèle, lieu ou HIN. Les marques, années, États et « jet ski » y sont reconnus.
make	text	Toute graphie utilisée par les encans : « SEA RAY », « Searay », « SEAR ».
hull	pontoon · bass · aluminum · center-console · bowrider · cruiser · wake · deck · sail · pwc	Genre de bateau.
source	copart_us · copart_ca · iaai_us · iaai_ca	Un encan.
country / region	us · ca / FL, TX, ON…	Un pays, ou un code d’État ou de province.
year_min / year_max	1950–2027	Plage d’années-modèles.
len_min / len_max	pieds	Longueur. Seulement les lots dont l’annonce en indique une, environ un sur cinq.
damage / title	flood, fire, … / salvage · rebuilt · parts	Catégories de dommage et de titre (voir /boats/makes).
lat / lng / radius	degrés, milles	Les plus proches d’un point d’abord, dans un rayon.
sort	newest · ending · sold_recent · price_desc · price_asc · year_desc · year_asc	« ending » : la vente la plus proche d’abord, puis les ventes passées, les plus récentes d’abord.
page / per_page	1–400 / 1–50	Pagination. 24 par page par défaut.

curl "https://salvagealert.com/api/v1/boats?make=sea%20ray&status=ended&sort=sold_recent" \
  -H "Authorization: Bearer $SA_API_KEY"

Réponse

{
  "total": 38,
  "page": 1,
  "per_page": 2,
  "pages": 19,
  "items": [
    {
      "id": "copart_us:70849645",
      "source": "copart_us",
      "lotKey": "70849645",
      "kind": "pwc",
      "hull": "pwc",
      "year": 2023,
      "make": "Yamaha",
      "model": "FX CRUISER",
      "hin": "YAMA2324F323",
      "location": "CHALFONT, PA",
      "regionCode": "PA",
      "status": "live",
      "saleDate": 1793710800000,
      "currency": "USD",
      "price": { "value": 3100, "currency": "USD", "basis": "current_bid" },
      "buyNow": null,
      "estRetail": 15933.8,
      "primaryDamage": "UNDERCARRIAGE",
      "damageBucket": "undercarriage",
      "title": "Salvage",
      "hasKeys": false,
      "images": ["https://…/1.jpg", "…"],
      "auctionUrl": "https://www.copart.com/lot/70849645"
    }
  ]
}

1 crédit

GET`/boats/{source}/{lot_key}`

Un lot : photos, HIN, dommages, chaque vente qu’il a connue, l’évolution des offres et le prix de vente de bateaux semblables.

curl "https://salvagealert.com/api/v1/boats/copart_us/70849645" \
  -H "Authorization: Bearer $SA_API_KEY"

Réponse

{
  "boat": {
    "id": "copart_us:70849645",
    "year": 2023, "make": "Yamaha", "model": "FX CRUISER",
    "hin": "YAMA2324F323",
    "status": "live",
    "price": { "value": 3100, "currency": "USD", "basis": "current_bid" },
    "primaryDamage": "UNDERCARRIAGE", "title": "Salvage",
    "hours": 41, "engine": null, "lengthFt": null,
    "images": ["https://…/1.jpg", "…"],
    "bidHistory": [{ "ts": 1793500000, "bid": 2600 }, { "ts": 1793590000, "bid": 3100 }],
    "saleEvents": [{ "saleDate": 1791200000000, "highBid": 2800, "currency": "USD", "kind": "auction" }],
    "auctionUrl": "https://www.copart.com/lot/70849645",
    "…": "63 fields in all"
  },
  "comps": {
    "basis": "2021–2025 Yamaha jet skis",
    "count": 12, "median": 4100, "low": 2600, "high": 6200,
    "currency": "USD", "items": [ … ]
  },
  "similar": [ … ]
}

1 crédit

GET`/boats/hin/{hin}`

Décoder un HIN et lister chaque annonce Copart et IAA qui l’a porté.

curl "https://salvagealert.com/api/v1/boats/hin/SERR2727K900" \
  -H "Authorization: Bearer $SA_API_KEY"

Réponse

{
  "hin": "SERR2727K900",
  "decode": {
    "mic": "SER",
    "builder": "Sea Ray",
    "serial": "R2727",
    "format": "current",
    "format_label": "Current format (since Aug 1984)",
    "productionMonth": 11,
    "productionYear": 1999,
    "modelYear": 2000,
    "certain": true,
    "issues": []
  },
  "builder_code": { "mic": "SER", "lots": 4, "makes": [{ "make": "Sea Ray", "count": 3 }] },
  "listings": []
}

Gratuit

GET`/boats/makes`

Les valeurs possibles des filtres : marques, types de coque, dommages, titres, régions.

curl "https://salvagealert.com/api/v1/boats/makes?kind=pwc" \
  -H "Authorization: Bearer $SA_API_KEY"

Erreurs

Les erreurs reviennent en JSON avec un code exploitable et un identifiant de requête à donner au soutien. Aucune ne coûte de crédit.

400	invalid_source · invalid_lot_key · invalid_hin	Un paramètre est erroné.
401	invalid_credentials	Clé absente, erronée ou révoquée.
402	insufficient_credits	Le solde est trop bas pour cet appel.
404	not_found	Ce lot n’existe pas.
429	rate_limit	Trop de requêtes cette minute; réessayez après x-ratelimit-reset.

{ "error": { "code": "insufficient_credits", "message": "…" }, "request_id": "4895a721-…" }

Besoin de plus que des bateaux?

La même clé donne accès à toute l’API de SalvageAlert : autos, camions et motos chez Copart et IAA dans quatre pays, webhooks, surveillance de NIV et statistiques de prix.

openapi.json Documentation de l’API SalvageAlert Créer un compte gratuit : 50 crédits

Bateaux accidentés, motomarines et HIN, en JSON

Démarrage rapide

Authentification

Crédits et limites

GET/boats

GET/boats/{source}/{lot_key}

GET/boats/hin/{hin}

GET/boats/makes

Erreurs

Besoin de plus que des bateaux?

GET`/boats`

GET`/boats/{source}/{lot_key}`

GET`/boats/hin/{hin}`

GET`/boats/makes`