Welcome to the Tipster API Integration Guide. This document is designed to provide you with comprehensive instructions on how to seamlessly integrate the Tipster API into your systems.

In the following sections, you will find detailed explanations and step-by-step guidance on how to access and utilize the endpoints of the Tipster API.

Customers that are consuming data feed have the possibility to request tips within a batch of fixtures. Our first step begins with mappings.

In THIS section you will find a list with the supported markets from each sport and their possible bet names.

Once markets are mapped, please follow these instructions.

Get started with Tipster API:

API Overview

Tipster API is designed using REST principles. Authentication is handled through access tokens, and all responses are returned with appropriate HTTP status codes and data formatted in JSON.

Authentication

Tipster API requires token. Token must be included in each request as apikey query parameter.

To generate the token use following GET request:

curl -X GET "https://api-spa.statscore.com/v2/oauth?client_id={cid}&secret_key={apikey}&product_id=14"

Get apikey and cid:

Follow these steps to obtain your client ID and client secret to generate the token:

Copy the apikey and cid from received email from Statscore

IP Restriction

Access to this API is restricted by IP address. Only requests originating from whitelisted IP addresses will be allowed. Please ensure that your requests are sent from an authorized IP address.

What Can You Do with the API?:

Dictionary:

Tips - are pieces of advice or information aimed at helping bettors make more informed decisions. This service provides types in the form of:

  { 
    "marketId": 102, 
    "text": "{away} scored less than 3.5 goals in 11 of the last 15 matches.", 
    "betName": "Under", 
    "betLine": "3.5" 
},

Prematch - refers to the scheduled matches or games that are planned to take place before they actually occur.
InPlay - refers to events that are currently ongoing and available for live.

Requests:

Request will only work after whitelisting your Back-End IPs
Api documenation https://tipster-api.statscore.com/api/doc?apikey={product_token} production host
Every request require add apikey query param e.g http://tipster-api.statscore.com/api/v3/widgetapi/batchprematch?fixtures=12890128%2C34579%2C8789&lang=en&apikey=test

Batch Prematch/InPlay Tips:

What it does: Allows you to fetch prematch tips.
How it works: You send your apikey with the fixture ids you are interested in and your language, and the system returns tips for these matches if they exist in the database.

Prematch/InPlay Tips:

What it does: Allows you to fetch tips by your fixture metadata.
How it works: You send your apikey with the name of the home team/player, name of the away team/player, start of the date match, sport name, user identifier, language and the system returns tips for these matches if they exist in the database.

Prematch/InPlay Fixtures:

What it does: Allows you to get information which fixtures have tips.
How it works: You send your apikey and the system returns list of fixture ids which have tips.

We hope this integration guide has provided you with the necessary tools and insights to successfully incorporate the Tipster API into your website. By leveraging the rich data and customizable features of our API, you can deliver a dynamic and engaging sports experience to your users. Remember, our STATSCORE Support Team is always available to assist you with any questions or issues you might encounter during the integration process.

Thank you for choosing Tipster API. We look forward to helping you enhance your sports content and achieve your business goals with our reliable and versatile service.

Tipster

Tipster API - integration guide