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.

Endpoints

Authentication

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 Links

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 Body

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

Example Requests

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

Response

Success (200)

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 Responses

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 Redirect

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 Parameters

Query Parameters

Example

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

Response

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

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

Error Responses

404 Not found

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

Deep Link Schema

Batch Response

Supported Sportsbooks

Deep links are available for 21 of 28 sportsbooks. State-specific books use the state parameter to generate the correct regional URL.

The following sportsbooks do not currently support deep links. IDs for these books will return null in the batch response:

Bet105, Bookmaker, Fliff, Rebet, SABA

Related Endpoints

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