BidSlammer Help: Api-documentation

New User Questions

Schnelllinks

Einloggen oder Passwort zurücksetzen

Berechtigung erneuern

Entwickler

Kontakt / Unterstützung

API-Dokumentation

Unsere API ist für Entwickler oder technikaffine Kunden. Sie können sie verwenden, um Anwendungen zu erstellen oder mit Ihren eigenen Tools und Dienstprogrammen, wie AppleScript, Abkürzungen zu erstellen.

Sie können die API von jedem Programm aus nutzen, das URLs abrufen kann. Verwenden Sie Ihre Snipes auf eine benutzerdefinierte Weise, die Sie erstellen! Bei Fragen zur Nutzung oder zu Bedingungen für die Nutzung in großem Umfang kontaktieren Sie uns bitte.

Um auf die API zuzugreifen, benötigen Sie einen API-Schlüssel. Dieser befindet sich im Tab „Einstellungen“, den Sie in der oberen Navigationsleiste sehen können, nachdem Sie sich angemeldet haben. Bitte beachten Sie: Die API erfordert ein Power Pack-Upgrade.

Hier ist eine funktionierende URL: https://api.bidslammer.com/justTesting?key=test-api-key&arg1=Hello&arg2=World!

Hinweis: Ein kostenpflichtiges Konto ist erforderlich, um die API zu nutzen.

Verfügbare Methoden

Sekundäre Funktionen

archiveItem
deleteSearch
getAllBidders
getBidGroupItems
getGalleryImages
getItemImages
getUserLogEntries
importBidList
importWatchList

justTesting

justTesting dient zum Ausprobieren der API.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`arg1`	string	(erforderlich) Jeder Wert; er wird in der Antwort zurückgegeben.
`arg2`	string	(optional) Jeder Wert; er wird in der Antwort zurückgegeben.
`arg3`	string	(optional) Jeder Wert; er wird in der Antwort zurückgegeben.

Beispielaufruf

https://api.bidslammer.com/justTesting?key={API_KEY}&arg1=Hello%2C+World

Gibt zurück:

{
    "status": "OK",
    "message": "Nun, die API scheint zu funktionieren.",
    "arg1": "Hello, World",
    "arg2": "",
    "arg3": "",
    "version": "1",
    "timestamp": "2020-03-01 21:41:53"
}

addBid

addBid dient zum Hinzufügen eines Snipe-Gebots.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`item_no`	integer	(erforderlich) Die Artikelnummer.
`bid`	float(2)	(optional) Der Gebotsbetrag. Standard ist null (0,00).
`newGroupName`	string	(optional) (Text) Der Name der Gebotsgruppe, zu der der Snipe hinzugefügt werden soll.
`delay`	integer	(optional) (ganzzahlig) Die Anzahl der Sekunden Vorlaufzeit, bevor der Snipe platziert wird. Werte können sein: Ganzzahlen von 1 bis 15 nur.
`enabled`	boolean	(optional) 0 oder 1. Den Snipe ein- oder ausschalten.
`force`	boolean	(optional) 0 oder 1. Ob der Gebotsbetrag auch dann erzwungen werden soll, wenn er niedriger ist als ein Gebot, das gewinnen wird. Wenn auf 1 gesetzt, wird das Gebot immer überschrieben, auch wenn dieser Wert verlieren wird.

Hinweis: Sobald eine neue Gruppe erstellt wurde, beziehen Sie sich immer auf sie mit ihrer `group_id`. Wenn Sie denselben `newGroupName` erneut angeben, wird dieselbe Gruppe verwendet, solange Sie in den letzten zehn (10) Tagen `addBid` für diese Gruppe verwendet haben. Mit anderen Worten, jedes Mal, wenn Sie `addBid` mit demselben `newGroupName` aufrufen, wird das letzte Nutzungsdatum der Gruppe zurückgesetzt, sodass keine neue Gruppe mit demselben Namen, aber einer anderen `group_id` erstellt wird. Dieses Verhalten existiert aus drei Gründen:

Um sicherzustellen, dass das UI-Dropdown nur kürzlich aktive Gruppen anzeigt.
Um die Wiederverwendung von Gruppennamen ohne Verwirrung zu ermöglichen.
Um zu verhindern, dass versehentlich eine alte Gruppe reaktiviert wird, nur weil sie denselben Namen hat.

Beispielsweise, wenn Sie letzten Monat eine Gruppe mit dem Namen "Star Wars" erstellt haben und dann heute eine weitere Gruppe mit demselben Namen erstellen, behandelt das System sie als getrennt—es sei denn, der ursprüngliche `groupName` war kürzlich aktiv.

Beispielaufruf

https://api.bidslammer.com/addBid?key={API_KEY}&item_no=123456789012&bid=0.01&force=1

Gibt zurück:

{
    "bid": "0.01",
    "delay": 7,
    "group_id": 123456,
    "groupName": "Testgruppe",
    "item_no": "153847324676",
    "status": "OK",
    "alert": "Erfolg",
    "short_message": "Gebot für 0.01 hinzugefügt.",
    "message": "Sie haben erfolgreich einen Snipe für 0.01 auf den eBay-Artikel #153847324676 hinzugefügt.",
    "message_color": "grün",
    "new_snipe": true
}

Bestimmung eines Gewinns: Wenn Sie die Snipe-Ergebnisse überprüfen, vergewissern Sie sich immer, dass success gleich 1 ist. Dies ist der definitive Weg, um einen Gewinn zu bestätigen. Verlassen Sie sich nicht auf das highBidder-Feld, da es das endgültige Auktionsergebnis möglicherweise nicht genau widerspiegelt.

deleteBid

deleteBid löscht einen Snipe vollständig aus dem System (wenn Sie den Snipe besitzen).

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`item_no`	integer	(erforderlich) Die Artikelnummer.

Beispielaufruf

https://api.bidslammer.com/deleteBid?key={API_KEY}&item_no=123456789012

addSearch

addSearch fügt eine Suche zu Ihrer Liste „Gespeicherte Suchen“ hinzu.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`query`	string	(erforderlich) Die Suchanfrage, die hinzugefügt werden soll (max. 255 Zeichen).

Beispielaufruf

https://api.bidslammer.com/addSearch?key={API_KEY}&country_code=US&query=Beanie+Babies

fetchItem

fetchItem ruft die neuesten Informationen für eine eBay-Artikelnummer ab, die in Ihrem Konto existiert. Hinweis: Dieser Endpunkt ist auf aktive Snipes beschränkt und kann nicht für allgemeine Artikelabfragen verwendet werden.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`item_no`	integer	(erforderlich) Die Artikelnummer.

Hinweis: Manchmal wird eine Auktion zu einer Festpreisauktion. In diesem Fall rufen Sie die Daten für diese Auktion ab, aber es werden die alten Auktionsdaten zurückgegeben. Dies liegt daran, dass der Verkäufer die Auktion stornieren und sagen kann, dass sie nicht mehr vorrätig ist. Dann wird sie als Festpreisangebot mit 0 Menge erneut aufgeführt. Es ist eine Schlupfloch, das Verkäufer nutzen, um die Anzahl der Aufrufe, die Verkehrsgeschichte und/oder die Feedbackaufzeichnung der Auflistung zu erhalten.

Beispielaufruf

https://api.bidslammer.com/fetchItem?key={API_KEY}&item_no=123456789012

Gibt zurück:

{
    "status": "OK",
    "alert": "Erfolg",
    "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": "Berechnet",
    "startTime": "2020-02-27 09:03:08",
    "timeLeft": "8h 8m",
    "category": "Alles andere: Testkategorie nur für den internen Gebrauch, übergeordnete Ebene 2: Allgemein",
    "endTime": "2020-03-05 09:03:08",
    "pictureURL": "https://i.ebayimg.com/00/s/NDgwWDY0MA==/z/nicAAOSwi5xeMhKl/$_12.JPG?set_id=880000500F",
    "title": "Kokosnuss-Limetten-Verbenen-Ananas-Koriander Zwei böse 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

checkSnipeStatus gibt den Gewinn-/Verluststatus des Artikels an. Bei einem Verlust wird der Grund angegeben. Wenn der Snipe nicht ausgeführt wurde, wird ein Status von "Ausstehend" zurückgegeben.

Hinweis: eBay benötigt manchmal bis zu 5 Minuten, um den Status eines Gebots zu bestätigen, warten Sie also immer mindestens 5 Minuten, nachdem die Auktion geschlossen wurde, um diesen API-Aufruf zu tätigen.

Parameter	Typ	Beschreibung
`item_no`	integer	Erforderlich. Die eBay-Artikelnummer, die überprüft werden soll.

Um einen definitiven Gewinn zu überprüfen, überprüfen Sie success == 1. Dies zeigt an, dass das System erfolgreich die API von eBay abgefragt hat und die Bestätigung erhalten hat, dass die Auktion gewonnen wurde.

Beispielaufruf

https://api.bidslammer.com/fetchItem?key={API_KEY}&item_no=123456789012

Gibt zurück:

{
    "bidResult": {
        "success": -7,
        "status": "Mindestgebotssteigerung nicht erreicht",
        "message": "Sie haben die Mindestgebotssteigerung für diesen Artikel nicht erreicht.",
        "shorthand": "gebotssteigerung",
        "color": "rot"
    },
    "item_info": {
        [same as fetchItem call]
    }
}

getUserItems

getUserItems gibt eine Liste von Benutzersnipes mit allen Parametern zurück.

Parameter	Typ	Beschreibung
`key`	string	(Erforderlich) Ihr API-Schlüssel.
`filter`	string	(Erforderlich) Gibt an, welche Liste von Artikeln zurückgegeben werden soll: • `watched` — Beobachtungsliste (gebot = 0) • `current` — Ausstehende/aktuelle Snipes • `completed` — Kürzlich abgeschlossene Snipes • `archive` — Archivierte Snipes (älter als 60 Tage)
`orderby`	string	(Optional) Feld, nach dem die Ergebnisse sortiert werden sollen. Mögliche Werte: `ends`, `bids`.
`dir`	string	(Optional) Sortierreihenfolge: `ASC` oder `DESC`.
`offset`	integer	(Optional) Anzahl der Datensätze, die in der zurückgegebenen Liste übersprungen werden sollen.
`limit`	integer	(Optional) Maximale Anzahl der zurückzugebenden Datensätze (max. 20).
`show_won`	boolean	(Optional) Auf 1 setzen, um "gewonnene" Artikel in den Ergebnissen einzuschließen, oder 0, um sie auszuschließen.

Hinweise:
- Wenn Sie filter=watched angeben, werden nur Artikel ohne Gebot zurückgegeben.
- Wenn Sie filter=current angeben, werden nur aktive Snipes angezeigt.
- limit darf nicht größer als 20 sein.

Beispielaufruf

https://api.bidslammer.com/getUserItems?key={API_KEY}&filter=current

Gibt zurück:

Ein Beispiel für eine JSON-Antwort für getUserItems:

[
  {
    "id": 10123,
    "snipe_id": 10123,
    "user_id": 555,
    "item_no": 123456789012,
    "title": "Vintage Star Wars Figur",
    "title_abbrev": "vintage star wars figur...",
    "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. Juli 2024",
    "ends_countdown": "3d 04h",
    "alertSet": 0,
    "note": "Möchte für Sammlung",
    "note_text": "Möchte für Sammlung",
    "note_date_pretty": "10. Juni",
    "jobs_arr": [
      {
        "fire_time": "2024-07-01 10:59:24",
        "status": "abgeschlossen"
      }
    ],
    "error_txt": "",
    "error_txt_short": "",
    "fee": 0,
    "overtime": -77322
  },
    // ... weitere Artikel ...
]

getUserSearches

getUserSearches gibt Ihre Liste der "Gespeicherten Suchen" zurück.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`filter`	string	(optional) Textzeichenfolge, um Suchen auf einen von Ihnen angegebenen Filter zu beschränken.

Wenn Sie einen filter in Ihrem Aufruf festlegen, werden nur Suchen zurückgegeben, deren Abfrage die Filterzeichenfolge enthält.

Beispielaufruf

https://api.bidslammer.com/getUserSearches?key={API_KEY}

Gibt zurück:

[
  {
    "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": "vintage wristwatch",
    "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": "retro camera",
    "searches": 16,
    "timestamp": "2023-07-20 18:55:30"
  }
    // ... weitere Suchen
]

getBidderDataset

getBidderDataset gibt Ihnen ein Dataset für die Gebotsgeschichte eines Artikels, das direkt in Chart.js oder QuickChart.io eingespeist werden kann. Ein zweites Dataset wird hinzugefügt, das eine horizontale Linie darstellt, die Ihren aktuellen Snipe-Wert darstellt.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`item_no`	integer	(erforderlich) Die Artikelnummer.

Beispielaufruf

https://api.bidslammer.com/getBidHistoryDataset?key={API_KEY}

Gibt zurück:

{
    "status": "OK",
    "data": {
        "datasets": [
            {
                "label": "Gebotsgeschichte",
                "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 }
                    // ... weitere Gebotsdatenpunkte ...
                ]
            },
            {
                "label": "Ihr 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 }
                ]
            }
            // ... weitere Datasets ...
        ]
    },
    "item_no": "1234567890",
    "bid": 40.00,
    "timestamp": "2024-06-01T12:45:00Z"
}

getBidHistoryDataset

getBidderDataset gibt Ihnen ein Dataset für die Gebotsgeschichte eines Artikels, das direkt in Chart.js Version 2 oder QuickChart.io unter Verwendung von version=2 eingespeist werden kann. Ein zweites Dataset wird hinzugefügt, das eine horizontale Linie darstellt, die Ihren aktuellen Snipe-Wert darstellt.

Parameter	Typ	Beschreibung
`key`	string	Erforderlich. Ihr API-Schlüssel.
`item_no`	integer	Erforderlich. Die Artikelnummer.

Beispielaufruf

https://api.bidslammer.com/getBidHistoryDataset?key=abcd&item_no=1234567890

Gibt zurück:

[
{
        "backgroundColor": "#0099c6",
        "borderColor": "#0099c6",
        "borderWidth": 0.25,
        "fill": false,
        "label": "LEGO Star Wars: Ewok Village (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": "Ihr Snipe von 5.00",
        "pointRadius": 1,
        "showLine": true
}
]

getSearchResults

getSearchResults gibt Suchergebnisse (bis zu 100 Artikel) von eBay für eine bestimmte Abfrage zurück.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`country_code`	string	(optional) 2-Buchstaben-Ländercode. Standard ist `US`. Beispiele: US, GB, AU.
`query`	string	(erforderlich) Die Suchanfrage.

Beispielaufruf

https://api.bidslammer.com/getSearchResults?key={API_KEY}&query=Beanie+Babies

getSuggestedCategories

getSuggestedCategories gibt eine Liste von vorgeschlagenen Kategorien für eine bestimmte Suchanfrage zurück und ob jede Kategorie eine Blattkategorie ist oder nicht. Sie können das Land angeben, um den richtigen Satz von Kategorien zu erhalten, da eBay für jedes Land einen anderen Kategoriensatz hat.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`country`	string	(optional) 2-Buchstaben-Ländercode (z.B. AU, US, DE, ES, GB usw.), der angibt, welchen Satz von Kategorienummern zu verwenden. Standard: US.
`maxResults`	integer	(optional) Die maximale Anzahl von Kategorievorschlägen, die zurückgegeben werden sollen. Standard: 10.
`query`	string	(erforderlich) Die Suchanfrage.

Beispielaufruf

https://api.bidslammer.com/getSuggestedCategories?key={API_KEY}&country=US&maxResults=20&query=Beanie+Babies

Sekundäre Funktionen

Diese Dienstprogrammfunktionen bieten zusätzliche Funktionalität zur Verwaltung Ihres Kontos und zum Abrufen ergänzender Daten.

archiveItem

archiveItem verschiebt einen abgeschlossenen Snipe in Ihr Archiv. Dies entfernt ihn aus Ihrer Liste „Abgeschlossen“ und legt ihn im Archiv für die langfristige Speicherung ab.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`item_id`	integer	(erforderlich) Die Snipe-ID oder Artikelnummer, die archiviert werden soll.

Beispielaufruf

https://api.bidslammer.com/archiveItem?key={API_KEY}&item_id=123456

Gibt zurück:

{
    "status": "OK"
}

deleteSearch

deleteSearch löscht eine gespeicherte Suche aus Ihrem Konto.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`id`	integer	(erforderlich) Die ID der zu löschenden gespeicherten Suche. (Verwenden Sie `getUserSearches`, um Such-IDs zu erhalten.)

Beispielaufruf

https://api.bidslammer.com/deleteSearch?key={API_KEY}&id=12345

Gibt zurück:

{
    "status": "OK",
    "id": 12345
}

getAllBidders

getAllBidders ruft die vollständige Gebotsgeschichte für eine eBay-Auktion ab und zeigt alle Bieter und deren Gebotsbeträge an.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`item_no`	integer	(erforderlich) Die eBay-Artikelnummer.

Beispielaufruf

https://api.bidslammer.com/getAllBidders?key={API_KEY}&item_no=123456789012

Gibt zurück:

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

getBidGroupItems ruft alle Ihre Gebotsgruppen und die Snipes innerhalb jeder Gruppe ab.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.

Beispielaufruf

https://api.bidslammer.com/getBidGroupItems?key={API_KEY}

Gibt zurück:

[
    {
        "group_id": 12345,
        "groupName": "Vintage Uhren",
        "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": "Vintage Omega Seamaster",
                "pictureURL": "https://i.ebayimg.com/images/g/xyz/s-l1600.jpg"
            },
            {
                "id": 98766,
                "item_no": 234567890123,
                "title": "Vintage Rolex Oyster",
                "pictureURL": "https://i.ebayimg.com/images/g/abc/s-l1600.jpg"
            }
        ]
    }
]

getGalleryImages

getGalleryImages ruft Miniaturbilder von Ihren abgeschlossenen Snipes ab, um sie in einer Galerieansicht anzuzeigen.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.

Beispielaufruf

https://api.bidslammer.com/getGalleryImages?key={API_KEY}

Gibt zurück:

[
    {
        "item_no": 123456789012,
        "pictureURL": "https://i.ebayimg.com/images/g/xyz/s-l1600.jpg",
        "title": "Vintage Star Wars Figur"
    },
    {
        "item_no": 234567890123,
        "pictureURL": "https://i.ebayimg.com/images/g/abc/s-l1600.jpg",
        "title": "Antike Taschenuhr"
    }
]

getItemImages

getItemImages ruft alle Bild-URLs für einen bestimmten eBay-Artikel ab.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`item_no`	integer	(erforderlich) Die eBay-Artikelnummer.

Beispielaufruf

https://api.bidslammer.com/getItemImages?key={API_KEY}&item_no=123456789012

Gibt zurück:

[
    "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

getUserLogEntries ruft Ihre Echtzeit-Snipe-Protokolleinträge ab und zeigt alle kürzlich durchgeführten Aktionen zu Ihren Snipes an.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.
`limit`	integer	(optional) Maximale Anzahl der zurückzugebenden Einträge. Standard: 100.

Beispielaufruf

https://api.bidslammer.com/getUserLogEntries?key={API_KEY}&limit=50

Gibt zurück:

[
    {
        "timestamp": "2024-07-01 10:59:24",
        "item_no": 123456789012,
        "hostname": "snipe-server-1",
        "comment": "Snipe erfolgreich bei $52.00 platziert"
    },
    {
        "timestamp": "2024-07-01 10:59:20",
        "item_no": 123456789012,
        "hostname": "snipe-server-1",
        "comment": "Snipe für Artikel #123456789012 wird vorbereitet"
    }
]

importBidList

importBidList importiert Ihre eBay-Gebotsliste (Artikel, auf die Sie derzeit bieten) in Ihr BidSlammer-Konto. Diese Artikel erscheinen in Ihrem Beobachtungs-Tab.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.

Hinweis: Dieser Vorgang kann je nach Größe Ihrer Gebotsliste bis zu einer Minute oder länger dauern.

Beispielaufruf

https://api.bidslammer.com/importBidList?key={API_KEY}

Gibt zurück:

{
    "bestOfferCount": 0,
    "biddingCount": 3,
    "totalWinningCost": "125.00",
    "wonCostUnit": "USD",
    "totalWonCost": "0.00",
    "winningCount": 1,
    "wonCount": 0,
    "wonDurationInDays": 60,
    "items": [
        {
            "item_no": 123456789012,
            "title": "Vintage Spielzeugauto",
            "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

importWatchList importiert Ihre eBay-Beobachtungsliste in Ihr BidSlammer-Konto. Diese Artikel erscheinen in Ihrem Beobachtungs-Tab, ohne dass ein Snipe-Gebot festgelegt ist.

Parameter	Typ	Beschreibung
`key`	string	(erforderlich) Ihr API-Schlüssel.

Hinweis: Dieser Vorgang kann je nach Größe Ihrer Beobachtungsliste bis zu einer Minute oder länger dauern.

Beispielaufruf

https://api.bidslammer.com/importWatchList?key={API_KEY}

Gibt zurück:

{
    "bestOfferCount": 0,
    "biddingCount": 0,
    "totalWinningCost": "0.00",
    "wonCostUnit": "USD",
    "totalWonCost": "0.00",
    "winningCount": 0,
    "wonCount": 0,
    "wonDurationInDays": 60,
    "items": [
        {
            "item_no": 123456789012,
            "title": "Vintage Spielzeugauto",
            "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": []
}

New User Questions

My Account

Site Operation

Bidding Analytics

BidWiser

Troubleshooting

Schnelllinks

API-Dokumentation

Verfügbare Methoden

Primäre Funktionen

Sekundäre Funktionen

justTesting

Beispielaufruf

Gibt zurück:

addBid

Beispielaufruf

Gibt zurück:

deleteBid

Beispielaufruf

addSearch

Beispielaufruf

fetchItem

Beispielaufruf

Gibt zurück:

checkSnipeStatus

Beispielaufruf

Gibt zurück:

getUserItems

Beispielaufruf

Gibt zurück:

getUserSearches

Beispielaufruf

Gibt zurück:

getBidderDataset

Beispielaufruf

Gibt zurück:

getBidHistoryDataset

Beispielaufruf

Gibt zurück:

getSearchResults

Beispielaufruf

getSuggestedCategories

Beispielaufruf

Sekundäre Funktionen

archiveItem

Beispielaufruf

Gibt zurück:

deleteSearch

Beispielaufruf

Gibt zurück:

getAllBidders

Beispielaufruf

Gibt zurück:

getBidGroupItems

Beispielaufruf

Gibt zurück:

getGalleryImages

Beispielaufruf

Gibt zurück:

getItemImages

Beispielaufruf

Gibt zurück:

getUserLogEntries

Beispielaufruf

Gibt zurück:

importBidList

Beispielaufruf

Gibt zurück:

importWatchList

Beispielaufruf

Gibt zurück: