Nuestra API es para desarrolladores o clientes con conocimientos informáticos. Puedes usarla para crear aplicaciones o hacer accesos directos utilizando tus propias herramientas y utilidades, como AppleScript.
Puedes usar la API desde cualquier programa que pueda obtener URLs. ¡Gestiona tus pujas de una manera personalizada que tú crees! Para preguntas sobre el uso o términos para un uso de alto volumen, por favor contáctanos.
Para acceder a la API, necesitarás una clave de API. Esta se encuentra en tu pestaña de Preferencias, que puedes ver en la barra de navegación superior después de iniciar sesión. Ten en cuenta: La API requiere una actualización de Power Pack.
Aquí tienes una URL de prueba:
https://api.bidslammer.com/justTesting?key=test-api-key&arg1=Hello&arg2=World!
Nota: Se requiere una cuenta de pago para usar la API.
justTesting es para probar la API.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
arg1 |
string | (requerido) Cualquier valor; será devuelto en la respuesta. |
arg2 |
string | (opcional) Cualquier valor; será devuelto en la respuesta. |
arg3 |
string | (opcional) Cualquier valor; será devuelto en la respuesta. |
https://api.bidslammer.com/justTesting?key={API_KEY}&arg1=Hello%2C+World
{
"status": "OK",
"message": "Bueno, la API parece estar funcionando.",
"arg1": "Hello, World",
"arg2": "",
"arg3": "",
"version": "1",
"timestamp": "2020-03-01 21:41:53"
}
addBid es para agregar una puja de snipe.
| parámetro | tipo | descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
item_no |
integer | (requerido) El número del artículo. |
bid |
float(2) | (opcional) El monto de la puja. El valor predeterminado es cero (0.00). |
newGroupName |
string | (opcional) (texto) El nombre del Grupo de Puja al que agregar el snipe. |
delay |
integer | (opcional) (entero) El número de segundos de anticipación antes de que se realice el snipe. Los valores pueden ser: enteros de valor 1 a 15 solamente. |
enabled |
boolean | (opcional) 0 o 1. Activa o desactiva el snipe. |
force |
boolean | (opcional) 0 o 1. Si se debe forzar el monto de la puja incluso si es inferior a una puja que ganará. Si se establece en 1, entonces la puja siempre será anulada, incluso si ese valor perderá. |
Nota: Una vez que se crea un nuevo grupo, siempre refiérete a él usando su `group_id`. Si especificas el mismo `newGroupName` nuevamente, se usará el mismo grupo, siempre que hayas usado `addBid` en ese grupo dentro de los últimos diez (10) días. En otras palabras, cada vez que llamas a `addBid` con el mismo `newGroupName`, restablece la fecha de último uso del grupo, por lo que no se crea un nuevo grupo con el mismo nombre pero un `group_id` diferente. Este comportamiento existe por tres razones:
https://api.bidslammer.com/addBid?key={API_KEY}&item_no=123456789012&bid=0.01&force=1
{
"bid": "0.01",
"delay": 7,
"group_id": 123456,
"groupName": "Grupo de prueba",
"item_no": "153847324676",
"status": "OK",
"alert": "éxito",
"short_message": "Puja añadida por 0.01.",
"message": "Has añadido con éxito un snipe por 0.01 en el artículo de eBay #153847324676.",
"message_color": "verde",
"new_snipe": true
}
Determinando una Victoria: Al verificar los resultados del snipe, siempre verifica que success sea igual a 1. Esta es la forma definitiva de confirmar una victoria. No confíes en el campo highBidder, ya que puede no reflejar con precisión el resultado final de la subasta.
deleteBid eliminará un snipe completamente del sistema (si eres el propietario del snipe).
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
item_no |
integer | (requerido) El número del artículo. |
https://api.bidslammer.com/deleteBid?key={API_KEY}&item_no=123456789012
addSearch agrega una búsqueda a tu lista de "Búsquedas Guardadas".
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
query |
string | (requerido) La consulta de búsqueda a agregar (máx. 255 caracteres). |
https://api.bidslammer.com/addSearch?key={API_KEY}&country_code=US&query=Beanie+Babies
fetchItem obtendrá la información más reciente para un número de artículo de eBay que existe en tu cuenta. Nota: Este endpoint está restringido solo a snipe activos y no se puede usar para búsquedas generales de artículos.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
item_no |
integer | (requerido) El número del artículo. |
Nota: A veces una subasta se convertirá en una subasta de Precio Fijo. En este caso, obtendrás los datos de esa subasta, pero devolverá los datos de la subasta antigua. Esto se debe a que el vendedor puede cancelar la subasta y decir que está fuera de stock. Luego se vuelve a listar como un anuncio de Precio Fijo con 0 cantidad. Es un vacío que los vendedores utilizan para preservar el conteo de vistas del anuncio, el historial de tráfico y/o el registro de comentarios.
https://api.bidslammer.com/fetchItem?key={API_KEY}&item_no=123456789012
{
"status": "OK",
"alert": "éxito",
"bids": 0,
"cost": 9.99,
"ends": "2020-03-05 09:03:08",
"eBayItemId": 153847324676,
"currentPrice": 9.99,
"currency": "USD",
"country": "US",
"sellerPercent": 100,
"sellerScore": 0,
"sellerUserId": "chinese*food*is*good",
"shippingType": "Calculado",
"startTime": "2020-02-27 09:03:08",
"timeLeft": "8h 8m",
"category": "Todo lo demás: Categoría de prueba para uso interno solo nivel padre 2: General",
"endTime": "2020-03-05 09:03:08",
"pictureURL": "https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/nicAAOSwi5xeMhKl/$_12.JPG?set_id=880000500F",
"title": "Coconut Lime Verbena Pineapple Cilantro Two Wicked 16oz",
"images": [
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/nicAAOSwi5xeMhKl/$_12.JPG?set_id=880000500F",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/wq0AAOSwUMpeMhK1/$_12.JPG?set_id=880000500F",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/bBQAAOSwPMpeMhK2/$_12.JPG?set_id=880000500F",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/XbIAAOSwepleMhK2/$_12.JPG?set_id=880000500F",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/PjYAAOSwmoheMhK3/$_12.JPG?set_id=880000500F",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/EgsAAOSwW1NeMhK4/$_12.JPG?set_id=880000500F",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/CLoAAOSw1T1eMhK5/$_12.JPG?set_id=880000500F"
],
"message": ""
}
checkSnipeStatus te dará el estado de victoria/pérdida del artículo. Si es una pérdida, dará la razón. Si el snipe no se ha ejecutado, devolverá un estado de "Pendiente."
Nota: eBay a veces requiere hasta 5 minutos para confirmar el estado de una puja, así que siempre espera al menos 5 minutos después de que la subasta cierre para hacer esta llamada a la API.
| Parámetro | Tipo | Descripción |
|---|---|---|
item_no |
integer | Requerido. El número del artículo de eBay a verificar. |
Para verificar una victoria definitiva, verifica success == 1. Esto indica que el sistema consultó con éxito la API de eBay y recibió confirmación de que la subasta fue ganada.
https://api.bidslammer.com/fetchItem?key={API_KEY}&item_no=123456789012
{
"bidResult": {
"success": -7,
"status": "Incremento de Puja Mínimo No Cumplido",
"message": "No cumpliste con el incremento mínimo de puja para este artículo.",
"shorthand": "bid-incr",
"color": "rojo"
},
"item_info": {
[same as fetchItem call]
}
}
getUserItems devuelve una lista de snipe de usuario con todos los parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (Requerido) Tu clave de API. |
filter |
string | (Requerido) Especifica qué lista de artículos devolver: • watched — Lista de seguimiento (puja = 0)• current — Snipe pendientes/actuales• completed — Snipe completados recientemente• archive — Snipe archivados (más de 60 días) |
orderby |
string | (Opcional) Campo para ordenar los resultados. Valores posibles: ends, bids. |
dir |
string | (Opcional) Dirección de ordenación: ASC o DESC. |
offset |
integer | (Opcional) Número de registros a omitir en la lista devuelta. |
limit |
integer | (Opcional) Número máximo de registros a devolver (máx. 20). |
show_won |
boolean | (Opcional) Establecer en 1 para incluir artículos "ganados" en los resultados, o 0 para excluir. |
Notas:
- Si especificas filter=watched, solo se devuelven artículos sin puja.
- Si especificas filter=current, solo se muestran snipe activos.
- limit no puede ser mayor que 20.
https://api.bidslammer.com/getUserItems?key={API_KEY}&filter=current
Una respuesta JSON de ejemplo para getUserItems:
[
{
"id": 10123,
"snipe_id": 10123,
"user_id": 555,
"item_no": 123456789012,
"title": "Figura Vintage de Star Wars",
"title_abbrev": "figura vintage star wars...",
"pictureURL": "https://i.ebayimg.com/images/g/xyz/s-l1600.jpg",
"item_url": "https://www.ebay.com/itm/123456789012",
"country": "US",
"group_id": 0,
"groupName": null,
"bid": 49.99,
"bids": 7,
"cost": 42.00,
"cost_unit": "USD",
"shipping_cost": "5.00",
"shipping_free": "0",
"shipping_min": null,
"shipping_max": null,
"shipping_priority": null,
"shipping_service": null,
"shipping_type": null,
"hasReservePrice": 0,
"numberOfImages": 3,
"seller_userid": "vintoys31",
"seller_percent": 99.7,
"seller_score": 3002,
"success": 1,
"won": 1,
"mbi": 1.00,
"min_bid_incr": 1.00,
"tableClass": "success",
"icon_src": "/img/legend_win_trans.png",
"ends": "2024-07-01 10:59:31",
"ends_pretty": "1 de Jul, 2024",
"ends_countdown": "3d 04h",
"alertSet": 0,
"note": "Quiero para colección",
"note_text": "Quiero para colección",
"note_date_pretty": "Jun 10",
"jobs_arr": [
{
"fire_time": "2024-07-01 10:59:24",
"status": "completo"
}
],
"error_txt": "",
"error_txt_short": "",
"fee": 0,
"overtime": -77322
},
// ... más artículos ...
]
getUserSearches devuelve tu lista de "Búsquedas Guardadas."
| parámetro | tipo | descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
filter |
string | (opcional) Cadena de texto para limitar las búsquedas a un filtro que especifiques. |
Si estableces un filter en tu llamada, solo se devolverán búsquedas cuya consulta contenga la cadena de filtro.
https://api.bidslammer.com/getUserSearches?key={API_KEY}
[
{
"id": 10123,
"auctions_only": true,
"cat_id": 6030,
"enabled": true,
"last_search": "2024-06-27 12:04:13",
"major_cat_id": 6,
"max_price": "75.00",
"min_price": "10.00",
"query": "reloj de pulsera vintage",
"searches": 88,
"timestamp": "2023-12-30 09:14:10"
},
{
"id": 10122,
"auctions_only": false,
"cat_id": 220,
"enabled": true,
"last_search": "2024-06-25 18:22:14",
"major_cat_id": 2,
"max_price": "45.00",
"min_price": "",
"query": "cámara retro",
"searches": 16,
"timestamp": "2023-07-20 18:55:30"
}
// ... más búsquedas
]
getBidderDataset te proporciona un conjunto de datos para el historial de pujas de un artículo que se puede alimentar directamente en Chart.js o QuickChart.io. Se añade un segundo conjunto de datos que es una línea horizontal que representa tu valor actual de snipe.
| parámetro | tipo | descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
item_no |
integer | (requerido) El número del artículo. |
https://api.bidslammer.com/getBidHistoryDataset?key={API_KEY}
{
"status": "OK",
"data": {
"datasets": [
{
"label": "Historial de Puja",
"backgroundColor": "#0099c6",
"borderColor": "#0099c6",
"fill": false,
"showLine": true,
"pointRadius": 4,
"pointHoverRadius": 12,
"data": [
{ "x": 1714944227000, "y": 25.00 },
{ "x": 1714945227000, "y": 30.00 },
{ "x": 1714946227000, "y": 35.00 }
// ... más puntos de datos de puja ...
]
},
{
"label": "Tu Snipe",
"backgroundColor": "rgba(255,0,0,0.1)",
"borderColor": "red",
"borderDash": [10, 5],
"pointRadius": 0,
"fill": false,
"data": [
{ "x": 1714944227000, "y": 40.00 },
{ "x": 1714946227000, "y": 40.00 }
]
}
// ... más conjuntos de datos ...
]
},
"item_no": "1234567890",
"bid": 40.00,
"timestamp": "2024-06-01T12:45:00Z"
}
getBidderDataset te proporciona un conjunto de datos para el historial de pujas de un artículo que se puede alimentar directamente en Chart.js versión 2 o QuickChart.io usando version=2. Se añade un segundo conjunto de datos que es una línea horizontal que representa tu valor actual de snipe.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | Requerido. Tu clave de API. |
item_no |
integer | Requerido. El número del artículo. |
https://api.bidslammer.com/getBidHistoryDataset?key=abcd&item_no=1234567890
[
{
"backgroundColor": "#0099c6",
"borderColor": "#0099c6",
"borderWidth": 0.25,
"fill": false,
"label": "LEGO Star Wars: Aldea Ewok (10236)",
"data": [
{
"x": 1714944227000,
"y": 600
},
{
"x": 1715048287000,
"y": 600
},
{
...
}
],
"pointRadius": 4,
"pointHoverRadius": 12,
"pointHoverBackgroundColor": "#0099c6",
"showLine": true
},
{
"borderCapStyle": "round",
"borderColor": "#0099c6",
"borderDash": [
10,
5
],
"borderWidth": 2,
"lineTension": 5,
"data": [
{
"x": 1714653979000,
"y": 600
},
{
"x": 1715084265000,
"y": 600
}
],
"fill": false,
"label": "Tu snipe de 5.00",
"pointRadius": 1,
"showLine": true
}
]
getSearchResults devolverá los resultados de búsqueda (hasta 100 artículos) de eBay para una consulta dada.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
country_code |
string | (opcional) Código de país de 2 letras. El valor predeterminado es US. Ejemplos: US, GB, AU. |
query |
string | (requerido) La consulta de búsqueda. |
https://api.bidslammer.com/getSearchResults?key={API_KEY}&query=Beanie+Babies
getSuggestedCategories devolverá una lista de categorías sugeridas para una consulta de búsqueda dada, y si cada categoría es o no una categoría hoja. Puedes especificar el país para obtener el conjunto correcto de categorías, ya que eBay tiene un conjunto de categorías diferente para cada país.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
country |
string | (opcional) Código de país de 2 letras (por ejemplo, AU, US, DE, ES, GB, etc.) que especifica qué conjunto de números de categoría usar. Predeterminado: US. |
maxResults |
integer | (opcional) El número máximo de sugerencias de categoría a devolver. Predeterminado: 10. |
query |
string | (requerido) La consulta de búsqueda. |
https://api.bidslammer.com/getSuggestedCategories?key={API_KEY}&country=US&maxResults=20&query=Beanie+Babies
Estas funciones de utilidad proporcionan funcionalidad adicional para gestionar tu cuenta y recuperar datos suplementarios.
archiveItem mueve un snipe completado a tu archivo. Esto lo elimina de tu lista de Completados y lo coloca en el Archivo para almacenamiento a largo plazo.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
item_id |
integer | (requerido) El ID del snipe o número de artículo a archivar. |
https://api.bidslammer.com/archiveItem?key={API_KEY}&item_id=123456
{
"status": "OK"
}
deleteSearch elimina una búsqueda guardada de tu cuenta.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
id |
integer | (requerido) El ID de la búsqueda guardada a eliminar. (Usa getUserSearches para obtener los IDs de búsqueda.) |
https://api.bidslammer.com/deleteSearch?key={API_KEY}&id=12345
{
"status": "OK",
"id": 12345
}
getAllBidders recupera el historial completo de pujas de una subasta de eBay, mostrando todos los postores y sus montos de puja.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
item_no |
integer | (requerido) El número del artículo de eBay. |
https://api.bidslammer.com/getAllBidders?key={API_KEY}&item_no=123456789012
{
"status": "OK",
"bidders": [
{
"userID": "b***r",
"maxBid": 52.00,
"bidTime": "2024-07-01 10:59:28"
},
{
"userID": "s***e",
"maxBid": 45.00,
"bidTime": "2024-06-30 14:22:15"
}
]
}
getBidGroupItems recupera todos tus Grupos de Puja y los snipe dentro de cada grupo.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
https://api.bidslammer.com/getBidGroupItems?key={API_KEY}
[
{
"group_id": 12345,
"groupName": "Relojes Vintage",
"created_at": "2024-06-15 09:30:00",
"updated_at": "2024-07-01 14:22:00",
"wins_desired": 1,
"wins_achieved": 0,
"items": [
{
"id": 98765,
"item_no": 123456789012,
"title": "Omega Seamaster Vintage",
"pictureURL": "https://i.ebayimg.com/images/g/xyz/s-l1600.jpg"
},
{
"id": 98766,
"item_no": 234567890123,
"title": "Rolex Oyster Vintage",
"pictureURL": "https://i.ebayimg.com/images/g/abc/s-l1600.jpg"
}
]
}
]
getGalleryImages recupera imágenes en miniatura de tus snipe completados para mostrarlas en una vista de galería.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
https://api.bidslammer.com/getGalleryImages?key={API_KEY}
[
{
"item_no": 123456789012,
"pictureURL": "https://i.ebayimg.com/images/g/xyz/s-l1600.jpg",
"title": "Figura Vintage de Star Wars"
},
{
"item_no": 234567890123,
"pictureURL": "https://i.ebayimg.com/images/g/abc/s-l1600.jpg",
"title": "Reloj de bolsillo antiguo"
}
]
getItemImages recupera todas las URLs de imágenes para un artículo específico de eBay.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
item_no |
integer | (requerido) El número del artículo de eBay. |
https://api.bidslammer.com/getItemImages?key={API_KEY}&item_no=123456789012
[
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/nicAAOSwi5xeMhKl/$_12.JPG",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/wq0AAOSwUMpeMhK1/$_12.JPG",
"https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/bBQAAOSwPMpeMhK2/$_12.JPG"
]
getUserLogEntries recupera tus entradas de Registro de Snipe en Tiempo Real, mostrando todas las acciones recientes realizadas en tus snipe.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
limit |
integer | (opcional) Número máximo de entradas a devolver. Predeterminado: 100. |
https://api.bidslammer.com/getUserLogEntries?key={API_KEY}&limit=50
[
{
"timestamp": "2024-07-01 10:59:24",
"item_no": 123456789012,
"hostname": "snipe-server-1",
"comment": "Snipe colocado con éxito a $52.00"
},
{
"timestamp": "2024-07-01 10:59:20",
"item_no": 123456789012,
"hostname": "snipe-server-1",
"comment": "Preparando snipe para el artículo #123456789012"
}
]
importBidList importa tu Lista de Puja de eBay (artículos en los que actualmente estás pujando) a tu cuenta de BidSlammer. Estos artículos aparecen en tu pestaña de Seguimiento.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
Nota: Esta operación puede tardar hasta un minuto o más dependiendo del tamaño de tu lista de pujas.
https://api.bidslammer.com/importBidList?key={API_KEY}
{
"bestOfferCount": 0,
"biddingCount": 3,
"totalWinningCost": "125.00",
"wonCostUnit": "USD",
"totalWonCost": "0.00",
"winningCount": 1,
"wonCount": 0,
"wonDurationInDays": 60,
"items": [
{
"item_no": 123456789012,
"title": "Coche de Juguete Vintage",
"pictureURL": "https://i.ebayimg.com/images/g/xyz/s-l1600.jpg",
"cost": "14.99",
"cost_unit": "USD",
"ends": "2024-07-14 23:57:00",
"bids": 2,
"sellerID": "vintage-seller-22"
}
],
"size": 3,
"status": "OK",
"errors": []
}
importWatchList importa tu Lista de Seguimiento de eBay a tu cuenta de BidSlammer. Estos artículos aparecen en tu pestaña de Seguimiento sin una puja de snipe establecida.
| Parámetro | Tipo | Descripción |
|---|---|---|
key |
string | (requerido) Tu clave de API. |
Nota: Esta operación puede tardar hasta un minuto o más dependiendo del tamaño de tu lista de seguimiento.
https://api.bidslammer.com/importWatchList?key={API_KEY}
{
"bestOfferCount": 0,
"biddingCount": 0,
"totalWinningCost": "0.00",
"wonCostUnit": "USD",
"totalWonCost": "0.00",
"winningCount": 0,
"wonCount": 0,
"wonDurationInDays": 60,
"items": [
{
"item_no": 123456789012,
"title": "Coche de Juguete Vintage",
"pictureURL": "https://i.ebayimg.com/images/g/xyz/s-l1600.jpg",
"cost": "14.99",
"cost_unit": "USD",
"ends": "2024-07-14 23:57:00",
"bids": 2,
"sellerID": "vintage-seller-22"
}
],
"size": 5,
"status": "OK",
"errors": []
}
¡Únete ahora gratis! Comienza a ganar artículos hoy.