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 for this section

AuthentifizierungPermalink for this section

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.

Batch-DeeplinksPermalink for this section

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 for this section

{
  "ids": ["17336125542407", "77b0749a1faae425", "abc1234567890def"],
  "state": "nj"
}

BeispielanfragenPermalink for this section

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"}'

const response = await fetch(
  'https://api.sharpapi.io/api/v1/deeplinks/batch',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      ids: ['17336125542407', '77b0749a1faae425'],
      state: 'nj'
    })
  }
);
const { data } = await response.json();
 
for (const [id, link] of Object.entries(data)) {
  if (link) {
    console.log(`${id}: https://api.sharpapi.io${link}`);
  } else {
    console.log(`${id}: not available`);
  }
}

import requests
 
response = requests.post(
    'https://api.sharpapi.io/api/v1/deeplinks/batch',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'ids': ['17336125542407', '77b0749a1faae425'],
        'state': 'nj'
    }
)
result = response.json()
 
for id, link in result['data'].items():
    if link:
        print(f"{id}: https://api.sharpapi.io{link}")
    else:
        print(f"{id}: not available")

AntwortPermalink for this section

Erfolg (200)Permalink for this section

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

FehlerantwortenPermalink for this section

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 for this section

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 — kein API key erforderlich.

PfadparameterPermalink for this section

Query-ParameterPermalink for this section

BeispielPermalink for this section

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

AntwortPermalink for this section

Erfolg (302 Found)Permalink for this section

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:

FehlerantwortenPermalink for this section

404 Nicht gefunden

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

Deeplink-SchemaPermalink for this section

Batch-AntwortPermalink for this section

Unterstützte SportsbooksPermalink for this section

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:

† Rebet löst zu einem Mobile-App-Link auf (com.rebet.app://…). Auf dem Desktop verwendet der Weiterleitungsendpunkt stattdessen Ihre fallback-URL 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 kein fallback ü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.

Verwandte EndpunktePermalink for this section

• +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