Deep Links

Generate sportsbook deep links from odds IDs or opportunity hash IDs. Deep links take users directly to the relevant event page on a sportsbook’s website, enabling one-click bet placement from your application.

EndpointsPermalink for this section

AuthenticationPermalink for this section

Requires API key for POST /deeplinks/batch. Available to Hobby tier and above.

The redirect endpoint (GET /deeplink/{id}) is public and does not require authentication — the opaque ID prevents enumeration.

Batch Deep LinksPermalink for this section

POST /api/v1/deeplinks/batch

Returns deep link redirect paths for multiple IDs in a single request. Accepts both odds IDs and opportunity hash IDs. Each ID in the request appears in the response — resolved IDs return a redirect path, unresolvable IDs return null.

Request BodyPermalink for this section

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

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

ResponsePermalink for this section

Success (200)Permalink for this section

The batch endpoint returns redirect paths, not direct sportsbook URLs. Prepend your base URL or use the path with the redirect endpoint to reach the sportsbook.

{
  "data": {
    "17336125542407": "/api/v1/deeplink/17336125542407",
    "77b0749a1faae425": "/api/v1/deeplink/77b0749a1faae425",
    "abc1234567890def": null
  },
  "updated_at": "2026-02-11T12:00:15.000Z"
}

Error ResponsesPermalink for this section

400 Missing IDs

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

400 Batch size exceeded

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

Deep Link RedirectPermalink for this section

GET /api/v1/deeplink/{id}

Redirects the user directly to the sportsbook page for a given odds ID or opportunity hash ID. This is a public endpoint — no API key required.

Path ParametersPermalink for this section

Query ParametersPermalink for this section

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

ResponsePermalink for this section

Success (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

The X-Deep-Link-Type header indicates the link specificity:

Error ResponsesPermalink for this section

404 Not found

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

Deep Link SchemaPermalink for this section

Batch ResponsePermalink for this section

Supported SportsbooksPermalink for this section

Deep link support is per sportsbook, and so is link specificity. Whether a link opens the event page or opens the bet slip with your selection already on it is decided by what that sportsbook’s own site accepts — not by which ID type you sent. The X-Deep-Link-Type header on the redirect tells you which one you got, per link.

Measured against production on 2026-08-25, across every sportsbook the API was serving at the time — 26 of 35 resolve a deep link, and 12 of those preselect the bet:

† Rebet resolves to a mobile app link (com.rebet.app://…). On desktop the redirect endpoint uses your fallback URL instead, and reports X-Deep-Link-Type: homepage.

‡ SBOBET and SX Bet resolve to a sport or league page rather than the individual event.

IDs for a sportsbook in the No group return null in the batch response, and the redirect endpoint returns 404 unless you pass fallback. Even on a supported sportsbook an individual ID can return null — not every market has a page. A sportsbook that was not publishing odds when this was measured is not listed.

Related EndpointsPermalink for this section

• +EV Opportunities - Source of hash_id values for +EV bets
• Arbitrage - Source of hash_id values for arbitrage opportunities
• Middles - Source of hash_id values for middle opportunities
• Low Hold - Source of hash_id values for low-hold opportunities