Sporting event videos
Applicable sites
Websites that provide legal video content related to sporting events.
What it adds to search results
Adds a section with video thumbnails to responses about matches, teams, and tournaments that match the user’s query. The user can go to the partner’s website to watch the video.
If multiple partners provide the same video, the user can choose the source.
How to set it up
The following types of videos can be broadcast:
|
Video type |
Display in search results |
Note |
|
Matches |
Displayed as a thumbnail. |
Only one video of this type can be broadcast for one match. |
|
Reviews and highlights |
A short clip with match highlights and goals can be embedded in the video carousel in sporting event search results. |
Only one video of this type can be broadcast for one match. Videos of this type must be available under FREE or AVOD models; videos of these types under SVOD/TVOD models are not added to search results. |
|
Goals |
||
|
Other sporting events |
— |
Search is based on information about sporting events received from partners. A partner can link the video content of their site to events presented in Yandex search results.
How to connect:
- Prepare the XML file in accordance with the format. The file must be accessible via HTTP request.
- Ensure that the video, the page where it is hosted, and the XML file meet the connection conditions.
- Send a request to sport-integrations@yandex-team.ru to connect the file.
Once the file passes moderation within 30 days, the content will appear in search results. If errors are found, Yandex specialists will email you. Make changes and send the request again.
Connection terms and conditions
- In the file, the partner must send the events for which there is a separate page at the time they are added to the file.
- The link must lead to the video for which it is specified in the file. Links to the home page of the site, tournament section, category, etc., are not allowed.
- The content’s cost must be specified excluding promotions. If you use the SVOD business model, specify the cost of one month of subscription.
- The partner must ensure that the data is current. If the broadcast is canceled or removed, include this information in the file. Yandex updates data received from the file every 10 minutes.
- If any clause is violated, Yandex has the right to suspend data integration and notify the partner.
|
General attributes |
||
|
Attribute |
Description |
Required |
|
|
ID of the video. |
Yes |
|
|
Tournament identifier. Required if the match identifier is not specified. See Sporting event identifiers. |
No |
|
|
Match identifier. Required for match videos. See Sporting event identifiers. |
Yes |
|
|
Video title. |
Yes |
|
|
Video duration in the format [HH:]MM:SS. |
Yes |
|
|
URL of the thumbnail image. |
Yes |
|
|
Indicates whether a video has been removed from search results. |
No |
|
|
Video priority (from 0 to 99). Can be used to manage the ranking of videos within the same type. This attribute does not affect the ranking of other partners’ videos. |
No |
|
|
Age restriction. Numeric value, e.g., |
No |
|
|
Date after which the video should be hidden (UNIX-timestamp in seconds). The attribute is required if:
Do not specify the attribute unless the contract has an expiration date. |
No |
|
|
URL of the video page on the partner’s site. |
Yes |
|
|
URL for embedding in iframe. |
No |
|
|
List of payment methods. Includes SVOD, EST, TVOD business models. |
Yes |
|
|
Tariff name. |
No |
|
|
Payment currency code. |
No |
|
|
Cost. Use a dot (.) as a separator. |
No |
|
|
URL of the page with the tariff’s terms and conditions. |
No |
|
|
Monetization model:
|
Yes |
|
Match broadcast attributes (videoevents, paid_videoevents) |
||
|
|
Broadcast status:
|
Yes |
|
|
Broadcast start date (UNIX-timestamp in seconds). |
Yes |
|
|
Broadcast end date (UNIX-timestamp in seconds). |
No |
|
|
Indicator of broadcast display after the event ends:
Used when the video is not available via direct link on your site immediately after the event ends. If the file simultaneously specifies the attributes |
No |
Example
<translations>
<translation id="9e45ccf6035b5120ac92b6a328b9378b" competition_id="113475" event_id="m545018">
<title>Corinthians — Juventude</title>
<video duration="02:20:00" img="//avatars.mds.yandex.net/get-ott/223007/90825590902296/orig" status="finished" hidden="0" start_time="1654975500">
<link>https://hd.kinopoisk.ru/sport/event/m545020?uuid=9e45ccf6035b5120ac92b6a328b9378b</link>
<embedded url="https://frontend.vh.yandex.ru/player/9e45ccf6035b5120ac92b6a328b9378b"/>
<pricing>
<option name="Plus" currency="RUB" price="660.24" url="https://yandex.ru/legal/kinopoisk_vod/" monetization_model="SVOD" />
<option name="Plus with Amediateka" currency="RUB" price="254.00" url="https://yandex.ru/legal/kinopoisk_vod/" monetization_model="SVOD" />
</pricing>
</video>
</translation>
<translation id="9e45ccf6035b5120ac92b6a328b9378b" competition_id="113475" event_id="m545018">
<title>Saint-Etienne - Brest</title>
<video duration="02:25:00" img="//avatars.mds.yandex.net/get-ott/223007/5588372664/orig" status="finished" hidden="0" start_time="1654975500">
<link>https://hd.kinopoisk.ru/sport/event/m545039?uuid=9e45ccf6035b5120ac92b6a328b9378b</link>
<pricing>
<option monetization_model="FREE" />
</pricing>
</video>
</translation>
</translations>
|
Attribute |
Description |
|
|
Match identifier. See Sporting event identifiers. |
|
|
Goal number. |
|
|
URL of the video page. |
|
|
URL of the thumbnail image. |
|
|
Date after which the video should be hidden (UNIX-timestamp in seconds). |
|
|
Age restriction. Numeric value, e.g., |
|
|
Video title. |
|
|
URL for embedding in iframe. |
|
|
List of payment methods in SVOD, EST, TVOD monetization models. |
|
|
Tariff name. |
|
|
Payment currency code. |
|
|
Cost. Use a dot (.) as a separator. |
|
|
URL of the page with the tariff’s terms and conditions. |
|
|
Monetization model:
|
Example
<events>
<event id="m545018">
<goal id="1" video="https://yandex.ru/sport/event/m545020?uuid=9e45ccf6035b5120ac92b6a328b9378b" img="//avatars.mds.yandex.net/get-ott/223007/908255909022">
<title>Corinthians — Juventude. 1 - 0</title>
<embedded url="https://frontend.vh.yandex.ru/player/9e45ccf6035b5120ac92b6a328b9378b"/>
</goal>
<goal id="2" video="https://yandex.ru/sport/event/m545020?uuid=9e45ccf6035b5120ac92b6a328b9378c" img="//avatars.mds.yandex.net/get-ott/223007/908255909023">
<title>Corinthians — Juventude. 1 - 1</title>
<embedded url="https://frontend.vh.yandex.ru/player/9e45ccf6035b5120ac92b6a328b9378b"/>
</goal>
</event>
</events>
Sporting event identifiers
The list of available identifiers can be found in the Event Directory.
Video removal
To remove a video from search results, add the hidden="1" attribute to the particular video in the XML file (see translations/translation/video/@hidden).