Skip to content

FAQ

How do I get the current match time in soccer?

The API provides timing information in the time object:

json
"time": {
  "initial": 2700,
  "max": 5400,
  "extra": 540,
  "currentPeriodStartTimestamp": 1701068460
}

Or in statusTime:

json
"statusTime": {
  "prefix": "",
  "initial": 2700,
  "max": 5400,
  "timestamp": 1701068460,
  "extra": 540
}

Fields:

  • initial - Duration of the half (in seconds)
  • max - Duration of the match (in seconds)
  • currentPeriodStartTimestamp / timestamp - Unix timestamp when the half started
  • extra - Injury time (in seconds)

Calculate current time:

current_time = current_timestamp - currentPeriodStartTimestamp

Is this API free?

Yes, there is a free tier with monthly request limits. For higher limits or custom plans, contact [email protected] or t.me/api_tipsters

How do I handle timezone?

The timezone parameter accepts values from -11 to 13. Use your local timezone offset. For example:

  • UTC+0 = 0
  • UTC+1 = 1
  • UTC-5 = -5

How do I paginate through results?

Many endpoints support pagination with page parameter (0-indexed):

  • Page 0 = First page
  • Page 1 = Second page
  • etc.

We’re dedicated to providing the best API products.