Skip to content

API Documentation (2.0.7)

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server

https://docs.goalise.com/_mock/apireference/openapi/

Goalise API Server

https://api.goalise.com/api/v2/

Countries

Countries

Operations

Leagues

Leagues

Operations

Matches

Matches

Operations

Teams

Teams

Operations

Players

Players

Operations

Transfers

Transfers

Operations

Venues

Venues

Operations

Predictions

Predictions

Operations

News

News

Operations

Get news categories

Request

Security
bearerAuth
curl -i -X GET \
  https://docs.goalise.com/_mock/apireference/openapi/news-categories \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news categories

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by category

Request

Returns a paginated list of news by category id

Security
bearerAuth
Query
idintegerrequired

Filter by category ID

Example: id=3
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-category?id=3&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by league

Request

Returns a paginated list of news by league id

Security
bearerAuth
Query
idintegerrequired

Filter by league ID

Example: id=618
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-league?id=618&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by team

Request

Returns a paginated list of news by team id

Security
bearerAuth
Query
idintegerrequired

Filter by team ID

Example: id=69
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-team?id=69&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by date

Request

Returns a paginated list of news by date

Security
bearerAuth
Query
datestringrequired

Date (format: Y-m-d)

Example: date=2025-03-01
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-date?date=2025-03-01&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get news html content

Request

Returns news html content by id

Security
bearerAuth
Query
idintegerrequired

News id

Example: id=275071
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-content?id=275071' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

News html content response

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

Example: null
errorsobject or null
Example: null
responseobject or null

Schema for a news article content

Response
application/json
{
  "status": "success",
  "pagination": null,
  "errors": null,
  "response": {
    "id": 177544,
    "title": "Barcelona sensation Lamine Yamal to take next step forward in injury recovery",
    "image": "https://cdn.goalise.com/news/uploads/01-01-2025/6526bcca719e3296421afca86a478292.jpg",
    "alias": "2025-01-01-barcelona-sensation-lamine-yamal-to-take-next-step-forward-in-injury-recovery",
    "original_url": "https://www.football-espana.net/2025/01/01/barcelona-sensation-lamine-yamal-to-take-next-step-forward-in-injury-recovery",
    "lang": "en",
    "published_at": "01-01-2025 23:17:12",
    "categories": [ … ],
    "leagues": [ … ],
    "teams": [ … ],
    "html_content": "<body>html of article here</body>",
    "html_content_scripts": "<script></script>"
  }
}

Odds

Odds

Operations