Skip to Content
API-ReferenzDeep Links

Deeplinks

Generieren Sie Sportsbook-Deeplinks aus Odds-IDs oder Opportunity-Hash-IDs. Deeplinks führen Benutzer direkt zur entsprechenden Event-Seite auf der Website eines Sportsbooks und ermöglichen so die Wettplatzierung mit einem Klick aus Ihrer Anwendung heraus.

EndpunktePermalink zu diesem Abschnitt

MethodePfadBeschreibung
POST/api/v1/deeplinks/batchDeeplinks für bis zu 500 IDs abrufen
GET/api/v1/deeplink/{id}Weiterleitung zu einem Sportsbook (öffentlich; ohne API key gilt ein Ratenlimit)

AuthentifizierungPermalink zu diesem Abschnitt

Erfordert einen API key für POST /deeplinks/batch. Verfügbar ab Hobby-Tarif und höher.

Der Weiterleitungsendpunkt (GET /deeplink/{id}) ist öffentlich und erfordert keine Authentifizierung — die undurchsichtige ID verhindert eine Aufzählung. Für eine Anfrage ohne API key gilt ein Ratenlimit; ein Programm, das viele Links öffnet, muss deshalb seinen Schlüssel senden.

Der Parameter id akzeptiert sowohl Odds-IDs (von /odds, /odds/best) als auch Opportunity-Hash-IDs (von +EV, Arbitrage, Middles und Low Hold Endpunkten). Beide ID-Typen werden zum genauesten Link aufgelöst, den das jeweilige Sportsbook unterstützt — die Genauigkeit hängt vom Sportsbook ab, nicht vom ID-Typ. Lesen Sie X-Deep-Link-Type in der Weiterleitung, um zu sehen, was Sie erhalten haben, und siehe den Abschnitt „Unterstützte Sportsbooks“ weiter unten für die Sportsbooks, die die Wette vorauswählen.


POST /api/v1/deeplinks/batch

Gibt Deeplink-Weiterleitungspfade für mehrere IDs in einer einzigen Anfrage zurück. Akzeptiert sowohl Odds-IDs als auch Opportunity-Hash-IDs. Jede ID in der Anfrage erscheint in der Antwort — aufgelöste IDs liefern einen Weiterleitungspfad, nicht auflösbare IDs liefern null.

Anfrage-BodyPermalink zu diesem Abschnitt

{ "ids": ["17336125542407", "77b0749a1faae425", "abc1234567890def"], "state": "nj" }
FeldTypStandardBeschreibung
idsstring[]erforderlichArray von Odds-IDs oder Opportunity-Hash-IDs (1–500 Elemente)
statestringpaUS-Bundesstaatencode nur für das Deep-Link-Ziel; filtert keine Quoten und liefert keine bundesstaatsspezifischen Preise. Verwendet die 50 US-Bundesstaatencodes sowie dc; dieser Batch-Endpunkt verwendet bei fehlenden, leeren oder nicht unterstützten Werten (einschließlich on) den Wert pa. Die Einzel-Link-Weiterleitung lehnt nicht unterstützte, nicht leere Codes ab.

BeispielanfragenPermalink zu diesem Abschnitt

curl -X POST "https://api.sharpapi.io/api/v1/deeplinks/batch" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ids": ["17336125542407", "77b0749a1faae425"], "state": "nj"}'

AntwortPermalink zu diesem Abschnitt

Erfolg (200)Permalink zu diesem Abschnitt

Der Batch-Endpunkt gibt Weiterleitungspfade zurück, keine direkten Sportsbook-URLs. Stellen Sie Ihre Basis-URL voran oder verwenden Sie den Pfad mit dem Weiterleitungsendpunkt, um zum Sportsbook zu gelangen.

{ "data": { "17336125542407": "/api/v1/deeplink/17336125542407", "77b0749a1faae425": "/api/v1/deeplink/77b0749a1faae425", "abc1234567890def": null }, "updated_at": "2026-02-11T12:00:15.000Z" }
WertBedeutung
"/api/v1/deeplink/{id}"Deeplink verfügbar — folgen Sie dem Weiterleitungspfad, um zum Sportsbook zu gelangen
nullKein Deeplink für diese ID verfügbar (nicht unterstützter Sportsbook, abgelaufene Odds oder ungültige ID)

Um die endgültige Sportsbook-URL zu erhalten, folgen Sie entweder der Weiterleitung (GET https://api.sharpapi.io/api/v1/deeplink/{id}) oder verwenden Sie den Pfad direkt in <a href>-Links — der Browser folgt der 302-Weiterleitung automatisch. Für ein Programm, das ohne API key viele Weiterleitungen verfolgt, gilt ein Ratenlimit.

FehlerantwortenPermalink zu diesem Abschnitt

400 Fehlende IDs

{ "error": { "code": "validation_error", "message": "ids array required" } }

400 Batch-Größe überschritten

{ "error": { "code": "validation_error", "message": "Maximum 500 IDs per batch" } }

GET /api/v1/deeplink/{id}

Leitet den Benutzer direkt zur Sportsbook-Seite für eine bestimmte Odds-ID oder Opportunity-Hash-ID weiter. Dies ist ein öffentlicher Endpunkt — er funktioniert ohne API key, aber für eine Anfrage ohne API key gilt ein Ratenlimit.

Verwenden Sie diesen Endpunkt in <a href>-Links, um Benutzer direkt zu einem Sportsbook zu senden. Die Antwort ist eine 302 Found-Weiterleitung, kein JSON.

PfadparameterPermalink zu diesem Abschnitt

ParameterTypBeschreibung
idstringErforderlich. Entweder eine numerische Odds-ID (z. B. 135102220304350) oder eine Opportunity-Hash-ID (16-stelliger Hex-Wert, z. B. 77b0749a1faae425)

Query-ParameterPermalink zu diesem Abschnitt

ParameterTypStandardBeschreibung
statestringpaUS-Bundesstaatencode nur für das Deep-Link-Ziel; filtert keine Quoten und liefert keine bundesstaatsspezifischen Preise. Akzeptiert die 50 US-Bundesstaatencodes sowie dc. Nicht unterstützte, nicht leere Codes (einschließlich on) liefern 400 invalid_filter. Fehlende oder leere Werte verwenden pa.
bookstring—Sportsbook-Filter (für Multi-Book-Opportunities wie Middles/Arbitrage)
fallbackstring—URL, zu der weitergeleitet wird, falls die ID nicht gefunden wurde. Wird nur für eine absolute http- oder https-URL ohne Port und ohne Benutzerangaben auf sharpapi.io, sharplines.io oder der Website eines Sportsbooks berücksichtigt, das der Endpunkt kennt (z. B. https://sportsbook.draftkings.com/); Subdomains zählen mit. Jeder andere Wert wird ignoriert: Eine gefundene ID wird wie gewohnt weitergeleitet, eine nicht gefundene ID liefert 404 not_found.

BeispielPermalink zu diesem Abschnitt

<!-- In your application HTML --> <a href="https://api.sharpapi.io/api/v1/deeplink/77b0749a1faae425?state=nj&book=draftkings"> Bet on DraftKings </a>

AntwortPermalink zu diesem Abschnitt

Erfolg (302 Found)Permalink zu diesem Abschnitt

HTTP/1.1 302 Found Location: https://sportsbook.draftkings.com/event/12345?outcomes=abc123 Cache-Control: private, max-age=60 X-Deep-Link-Type: outcome

Der Header X-Deep-Link-Type gibt die Spezifität des Links an:

WertBeschreibung
outcomeDirekter Link zu einer bestimmten Wettauswahl (mit Auswahl-ID)
eventLink zur Event-Seite (keine bestimmte Auswahl)
homepageFallback zur Sportsbook-Startseite

FehlerantwortenPermalink zu diesem Abschnitt

404 Nicht gefunden

{ "error": { "code": "not_found", "message": "Deep link ID not found" } }

Wenn der Query-Parameter fallback eine akzeptierte URL ist (siehe die Parametertabelle oben) und die ID nicht gefunden wird, leitet der Endpunkt zu dieser URL weiter, anstatt eine 404-JSON-Antwort zurückzugeben. Einen fallback, den der Endpunkt nicht akzeptiert, ignoriert er, und die obige 404-Antwort wird zurückgegeben.


Ratenlimit ohne API keyPermalink zu diesem Abschnitt

Die Weiterleitung bleibt öffentlich, aber jede Anfrage an api.sharpapi.io ohne API key wird pro Client-Adresse begrenzt: 12 Anfragen pro Minute, mit einem Burst-Kontingent von 5. IPv6-Clients werden pro /64-Netz gezählt. Die Bet-Link-Weiterleitung unterliegt diesem Limit wie jede andere Anfrage ohne Schlüssel. Eine Anfrage mit API key unterliegt diesem Limit für Anfragen ohne Schlüssel nicht.

Über dem Limit lautet die Antwort 429 mit dem Header Retry-After: 10 (Sekunden):

{ "error": { "code": "rate_limited", "message": "Too many unauthenticated requests. Get a free API key at sharpapi.io", "retryAfter": 10 } }

Was zu tun ist:

  • Eine Person, die im Browser auf Links klickt, bleibt weit unter dem Limit. Nichts zu tun: Lassen Sie die Links in Ihrer Webseite ohne Schlüssel.
  • Ein Programm, das Weiterleitungen in großer Zahl verfolgt (zum Beispiel um die endgültigen Sportsbook-Adressen auf einem Server aufzulösen), muss seinen API key senden, seine Anfragen zeitlich strecken und das Aufgelöste zwischenspeichern. Der Batch-Endpunkt oben liefert Weiterleitungspfade, keine endgültigen Sportsbook-Adressen, er erspart also den Weiterleitungsschritt nicht.
  • Setzen Sie nie einen API key in einen Link, der Ihren eigenen Nutzern angezeigt wird. Ein <a href> mit api_key= gibt Ihren Schlüssel an jeden Besucher weiter.

Senden Sie den Schlüssel im Header X-API-Key (empfohlen), in einem Authorization: Bearer-Header oder als Query-Parameter api_key. Alle drei Wege stehen unter Authentifizierung. Eine serverseitige Anfrage, die einen Link auflöst:

curl -i -H "X-API-Key: YOUR_API_KEY" \ "https://api.sharpapi.io/api/v1/deeplink/77b0749a1faae425?state=nj"

Wenn eine ID mit 404 not_found antwortet, hilft es nicht, dieselbe ID erneut abzufragen. Neue Zeilen tragen neue Links.


Batch-AntwortPermalink zu diesem Abschnitt

FeldTypBeschreibung
dataobjectZuordnung von ID zu Weiterleitungspfad (string) oder null, falls nicht verfügbar
updated_atstringISO-8601-Zeitstempel der Odds-Daten

Unterstützte SportsbooksPermalink zu diesem Abschnitt

Deeplink-Unterstützung ist sportsbook-spezifisch — und die Link-Genauigkeit ebenso. Ob ein Link die Event-Seite öffnet oder den Wettschein mit Ihrer Auswahl bereits darin, entscheidet die Website des jeweiligen Sportsbooks — nicht der gesendete ID-Typ. Der Header X-Deep-Link-Type der Weiterleitung nennt Ihnen pro Link, was Sie bekommen haben.

Gemessen in der Produktion am 2026-08-25, über alle Sportsbooks, die die API zu diesem Zeitpunkt ausgeliefert hat — 26 von 35 lösen einen Deeplink auf, und 12 davon wählen die Wette vor:

SportsbookDeeplinkWählt Ihre Auswahl vorBundesstaatsspezifisch
BallyBetJaJaNein
BetMGMJaJaJa
betPARXJaJaNein
BetRiversJaJaJa
BetwayJaJaNein
BovadaJaJaNein
bwinJaJaNein
CaesarsJaJaJa
DraftKingsJaJaNein
FanDuelJaJaNein
Hard RockJaJaNein
UnibetJaJaNein
1xBetJaNeinNein
BetanoJaNeinNein
BetOnlineJaNeinNein
KalshiJaNeinNein
LadbrokesJaNeinNein
NovigJaNeinNein
PinnacleJaNeinNein
PolymarketJaNeinNein
ProphetXJaNeinNein
SportzinoJaNeinNein
StakeJaNeinNein
Rebet †App-LinkNeinNein
SBOBET ‡TeilweiseNeinNein
SX Bet ‡TeilweiseNeinNein
Betfair ExchangeNein——
CircaNein——
FanaticsNein——
FliffNein——
GoldrushNein——
SABANein——
SkyBetNein——
theScore BetNein——
UnderdogNein——

† Rebet löst zu einem Mobile-App-Link auf (com.rebet.app://…). Auf dem Desktop verwendet der Weiterleitungsendpunkt stattdessen Ihre fallback-URL, sofern er sie akzeptiert, und meldet X-Deep-Link-Type: homepage.

‡ SBOBET und SX Bet lösen zu einer Sportart- oder Liga-Seite auf statt zum einzelnen Event.

IDs eines Sportsbooks aus der Nein-Gruppe liefern null in der Batch-Antwort, und der Weiterleitungsendpunkt gibt 404 zurück, sofern Sie keine akzeptierte fallback-URL übergeben. Auch bei einem unterstützten Sportsbook kann eine einzelne ID null liefern — nicht jeder Markt hat eine Seite. Ein Sportsbook, das zum Messzeitpunkt keine Quoten veröffentlicht hat, ist nicht aufgeführt.

Pinnacle-Deeplinks können keine Wette vorauswählen. Pinnacles Link ist eine Matchup-Seite (https://www.pinnacle.com/en/all-sports/matchup/{id}) ohne Auswahl-Parameter, der Ihr Ergebnis übertragen könnte — er bleibt also auf Event-Ebene, egal ob Sie eine numerische Odds-ID oder eine Opportunity-Hash-ID senden. Die Auswahl trifft der Wettende auf der Seite.

Verwandte EndpunktePermalink zu diesem Abschnitt

  • +EV-Opportunities - Quelle von hash_id-Werten für +EV-Wetten
  • Arbitrage - Quelle von hash_id-Werten für Arbitrage-Opportunities
  • Middles - Quelle von hash_id-Werten für Middle-Opportunities
  • Low Hold - Quelle von hash_id-Werten für Low-Hold-Opportunities
Last updated on