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
| Methode | Pfad | Beschreibung |
|---|---|---|
POST | /api/v1/deeplinks/batch | Deeplinks 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.
Batch-DeeplinksPermalink zu diesem Abschnitt
POST /api/v1/deeplinks/batchGibt 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"
}| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
ids | string[] | erforderlich | Array von Odds-IDs oder Opportunity-Hash-IDs (1–500 Elemente) |
state | string | pa | US-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
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"
}| Wert | Bedeutung |
|---|---|
"/api/v1/deeplink/{id}" | Deeplink verfügbar — folgen Sie dem Weiterleitungspfad, um zum Sportsbook zu gelangen |
null | Kein 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"
}
}Deeplink-WeiterleitungPermalink zu diesem Abschnitt
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
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Erforderlich. 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
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
state | string | pa | US-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. |
book | string | — | Sportsbook-Filter (für Multi-Book-Opportunities wie Middles/Arbitrage) |
fallback | string | — | 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: outcomeDer Header X-Deep-Link-Type gibt die Spezifität des Links an:
| Wert | Beschreibung |
|---|---|
outcome | Direkter Link zu einer bestimmten Wettauswahl (mit Auswahl-ID) |
event | Link zur Event-Seite (keine bestimmte Auswahl) |
homepage | Fallback 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>mitapi_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.
Deeplink-SchemaPermalink zu diesem Abschnitt
Batch-AntwortPermalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
data | object | Zuordnung von ID zu Weiterleitungspfad (string) oder null, falls nicht verfügbar |
updated_at | string | ISO-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:
| Sportsbook | Deeplink | Wählt Ihre Auswahl vor | Bundesstaatsspezifisch |
|---|---|---|---|
| BallyBet | Ja | Ja | Nein |
| BetMGM | Ja | Ja | Ja |
| betPARX | Ja | Ja | Nein |
| BetRivers | Ja | Ja | Ja |
| Betway | Ja | Ja | Nein |
| Bovada | Ja | Ja | Nein |
| bwin | Ja | Ja | Nein |
| Caesars | Ja | Ja | Ja |
| DraftKings | Ja | Ja | Nein |
| FanDuel | Ja | Ja | Nein |
| Hard Rock | Ja | Ja | Nein |
| Unibet | Ja | Ja | Nein |
| 1xBet | Ja | Nein | Nein |
| Betano | Ja | Nein | Nein |
| BetOnline | Ja | Nein | Nein |
| Kalshi | Ja | Nein | Nein |
| Ladbrokes | Ja | Nein | Nein |
| Novig | Ja | Nein | Nein |
| Pinnacle | Ja | Nein | Nein |
| Polymarket | Ja | Nein | Nein |
| ProphetX | Ja | Nein | Nein |
| Sportzino | Ja | Nein | Nein |
| Stake | Ja | Nein | Nein |
| Rebet † | App-Link | Nein | Nein |
| SBOBET ‡ | Teilweise | Nein | Nein |
| SX Bet ‡ | Teilweise | Nein | Nein |
| Betfair Exchange | Nein | — | — |
| Circa | Nein | — | — |
| Fanatics | Nein | — | — |
| Fliff | Nein | — | — |
| Goldrush | Nein | — | — |
| SABA | Nein | — | — |
| SkyBet | Nein | — | — |
| theScore Bet | Nein | — | — |
| Underdog | Nein | — | — |
† 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