search Method — Match Search

Purpose

The search method finds matches by team or participant name.

Live and Prematch are searched separately. A response may contain matches from multiple sports available to the client’s API key.

The method returns short match summaries without odds. To retrieve complete data and odds for a selected match, call event using its game_id.

Request

GET https://YOUR_API_DOMAIN/v1/search/{type}/{lang}/{text}

Send the API key in the HTTP header:

Package: YOUR_API_KEY

Path Parameters

Values of type:

Search Live and Prematch separately. One request does not search both line types.

Search Text Language

For relevant results, enter the name in the language specified by lang:

Search supports partial names. For example, Manchester may return matches involving Manchester City, Manchester United, and other participants whose names contain that text.

SportAPI determines the matches and their order. The method has no parameters for selecting a sport, country, tournament, result count, or page.

URL-encoding the Search Text

The text value is part of the URL, so spaces and special characters must be encoded.

For example, the text:

Manchester City

becomes:

Manchester%20City

In JavaScript, use encodeURIComponent():

const text = encodeURIComponent('Manchester City');
const url = `https://YOUR_API_DOMAIN/v1/search/line/en/${text}`;

Do not insert unprocessed user input into the URL.

Live Request Example

Search for matches containing Perth:

curl --request GET \
  --url 'https://YOUR_API_DOMAIN/v1/search/live/en/Perth' \
  --header 'Package: YOUR_API_KEY'

Prematch Request Example

Search for matches containing Manchester:

curl --request GET \
  --url 'https://YOUR_API_DOMAIN/v1/search/line/en/Manchester' \
  --header 'Package: YOUR_API_KEY'

Shortened Live Response Example

The following is one match from a real English search response for Perth:

{
  "status": 1,
  "page": "/v1/search",
  "body": [
    {
      "sgame_id": "69a6e9d05e99bd05c6f13963",
      "stat_id": "699986ec5e99bd05c6ea5357",
      "game_id": 746266480,
      "game_mid": 746266480,
      "game_start": 1787382000,
      "tournament_id": 980455,
      "tournament_name": "Australia. NPL. Western Australia",
      "opp_1_name": "Armadale",
      "opp_2_name": "Perth RedStar",
      "opp_1_icon": "398cfbf18abf67a8a1a27bbe2fc0b250.png",
      "opp_2_icon": "1c1a28702cd883376ed2516e4b123de6.png",
      "sport_id": 1,
      "sport_name": "Football",
      "score_full": "0:3",
      "period_name": "period",
      "timer": 4501,
      "country_id": 4,
      "country_name": "Australia"
    }
  ]
}

Scores, timers, and the contents of the sports line change over time.

Response Structure

Top-level Fields

Results are not grouped by sport, country, or tournament.

Match Fields

The search response does not contain game_oc_list, stat_list, sub_games, event_plan, va, vi, or zp. Retrieve these fields through other methods using game_id.

All common fields are documented in the Sport Line API Field Reference.

Icons

Build the sport icon URL from sport_id:

https://cdn.sportapi.net/sports/v1/color/{sport_id}.webp

Build the country icon URL from country_id:

https://cdn.sportapi.net/flags/v1/color/{country_id}.webp

Build the tournament icon URL from tournament_id:

https://cdn.sportapi.net/tournaments/v1/color/{tournament_id}.webp

For a team icon, remove the extension from opp_1_icon or opp_2_icon and insert the remaining name into the URL:

https://cdn.sportapi.net/opp/v1/color/{iconName}.webp

No Matches Found

No matches being found is not an error. The API returns a successful response with an empty body array:

{
  "status": 1,
  "page": "/v1/search",
  "body": []
}

Display this response as “No matches found” in the interface.

Subscription Restrictions

The response contains only matches from sports and languages available to the client’s API key. One request may return matches from several available sports.

Snapshot of Saved Responses

The Live examples used the Perth search, while the Prematch examples used Manchester.

These result counts apply only to snapshots retrieved on August 22, 2026. They are not permanent method limits.

Full unabridged responses:

• Live, Russian response
• Live, English, search for “Perth”
• Prematch, Russian response
• Prematch, English, search for “Manchester”

The files contain only API response bodies. No API key is stored in them.

When to Make the Request

search is intended to run in response to a user action. It does not require a continuous background update loop. Send a new request after the user enters or changes the search text.

Key, subscription, and parameter errors are documented in Error Handling.