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.

Endpunkte

Authentifizierung

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-Deeplinks

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-Body

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

Beispielanfragen

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

Antwort

Erfolg (200)

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

Fehlerantworten

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-Weiterleitung

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.

Pfadparameter

Query-Parameter

Beispiel

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

Antwort

Erfolg (302 Found)

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:

Fehlerantworten

404 Nicht gefunden

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

Deeplink-Schema

Batch-Antwort

Unterstützte Sportsbooks

Deeplinks sind für 21 von 28 Sportsbooks verfügbar. Bundesstaatsspezifische Sportsbooks verwenden den Parameter state, um die korrekte regionale URL zu generieren.

Die folgenden Sportsbooks unterstützen derzeit keine Deeplinks. IDs für diese Sportsbooks geben in der Batch-Antwort null zurück:

Bet105, Bookmaker, Fliff, Rebet, SABA

Verwandte Endpunkte

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