API para desarrolladores

Botes siniestrados, motos acuáticas y HIN, en JSON

Cada bote y moto acuática de Copart e IAA en EE. UU. y Canadá, próximos y vendidos con la última oferta, más un decodificador de HIN. REST sencillo, una clave, pagado con créditos de SalvageAlert.

Crear una cuenta gratis: 50 créditos Inicio rápido

50 créditos gratis: con una cuenta gratuita
60+ solicitudes/min: más en los planes de pago
OpenAPI 3: para Postman y generadores de SDK

Inicio rápido

1
Crear una cuenta gratis
Es una cuenta de SalvageAlert y viene con 50 créditos de API.
2
Crear una clave
En su cuenta, en API. Cópiela: solo se muestra una vez.
3
Hacer una llamada
Envíela como token Bearer. Cada llamada indica lo que costó y lo que queda.

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

Autenticación

Cada solicitud lleva su clave en el encabezado Authorization. Las claves empiezan por sa_live_, funcionan en los endpoints de boat.vin y en todos los de SalvageAlert, y se pueden revocar en cualquier momento desde su cuenta. Guárdelas en su servidor: nunca en una página web ni en una app.

URL base

https://salvagealert.com/api/v1

Encabezado

Authorization: Bearer sa_live_…

Créditos y límites

Las llamadas se pagan con créditos de la API de SalvageAlert, el mismo saldo que la API de autos. Una cuenta gratuita de boat.vin empieza con 50. Los planes de pago de SalvageAlert añaden 500 o 5.000 al mes, y los paquetes de créditos recargan cualquier cuenta. Los errores nunca se cobran.

Endpoint	Costo
GET /boats	1 crédito por página
GET /boats/{source}/{lot_key}	1 crédito
GET /boats/hin/{hin}	1 crédito
GET /boats/makes	Gratis

Cada respuesta lleva x-credits-charged, x-credits-balance, x-ratelimit-limit, x-ratelimit-remaining y x-request-id. El plan gratuito permite 60 solicitudes por minuto.

Comprar créditos

1 crédito por página

GET`/boats`

Buscar botes y motos acuáticas, próximos y vendidos, con todos los filtros de boat.vin.

Parámetro	Valores	Qué hace
status	live · ended · all	Las subastas próximas y en curso, el archivo de ventas, o ambas (por defecto).
kind	boat · pwc	Botes, o motos acuáticas y embarcaciones personales.
q	text	Texto libre: marca, modelo, lugar o un HIN. Se reconocen marcas, años, estados y “jet ski”.
make	text	Cualquier forma en que la escriban las subastas: “SEA RAY”, “Searay”, “SEAR”.
hull	pontoon · bass · aluminum · center-console · bowrider · cruiser · wake · deck · sail · pwc	Clase de bote.
source	copart_us · copart_ca · iaai_us · iaai_ca	Una subasta.
country / region	us · ca / FL, TX, ON…	Un país, o un código de estado o provincia.
year_min / year_max	1950–2027	Rango de años del modelo.
len_min / len_max	pies	Eslora. Solo los lotes cuyo anuncio la indica, uno de cada cinco más o menos.
damage / title	flood, fire, … / salvage · rebuilt · parts	Categorías de daño y de título (vea /boats/makes).
lat / lng / radius	grados, millas	Los más cercanos a un punto primero, dentro de un radio.
sort	newest · ending · sold_recent · price_desc · price_asc · year_desc · year_asc	“ending”: primero la venta más próxima, luego las ventas pasadas, de la más reciente a la más antigua.
page / per_page	1–400 / 1–50	Paginación. 24 por página por defecto.

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

Respuesta

{
  "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édito

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

Un lote: fotos, HIN, daños, cada venta por la que pasó, su historial de ofertas y por cuánto se vendieron botes similares.

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

Respuesta

{
  "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édito

GET`/boats/hin/{hin}`

Decodificar un HIN y listar cada anuncio de Copart e IAA que lo llevó.

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

Respuesta

{
  "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": []
}

Gratis

GET`/boats/makes`

Los valores que aceptan los filtros: marcas, tipos de casco, daños, títulos, regiones.

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

Errores

Los errores llegan en JSON con un código que puede evaluar y un identificador de solicitud para soporte. Ninguno cuesta créditos.

400	invalid_source · invalid_lot_key · invalid_hin	Un parámetro es incorrecto.
401	invalid_credentials	Clave ausente, incorrecta o revocada.
402	insufficient_credits	El saldo es demasiado bajo para esta llamada.
404	not_found	Ese lote no existe.
429	rate_limit	Demasiadas solicitudes este minuto; reintente después de x-ratelimit-reset.

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

¿Necesita más que botes?

La misma clave da acceso a toda la API de SalvageAlert: autos, camionetas y motos en Copart e IAA en cuatro países, webhooks, vigilancia de VIN y estadísticas de precios.

openapi.json Documentación de la API de SalvageAlert Crear una cuenta gratis: 50 créditos

Botes siniestrados, motos acuáticas y HIN, en JSON

Inicio rápido

Autenticación

Créditos y límites

GET/boats

GET/boats/{source}/{lot_key}

GET/boats/hin/{hin}

GET/boats/makes

Errores

¿Necesita más que botes?

GET`/boats`

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

GET`/boats/hin/{hin}`

GET`/boats/makes`