Skip to content

Commit

Permalink
SEO quick fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
szekelyzol committed Oct 2, 2024
1 parent b962c2a commit 8d36d83
Show file tree
Hide file tree
Showing 10 changed files with 24 additions and 24 deletions.
2 changes: 1 addition & 1 deletion analytics/overview.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Analytics
breadcrums: false
breadcrumbs: false
meta:
description: Learn how you can get data insights for your videos and live streams using api.video's Analytics solution.
---
Expand Down
2 changes: 1 addition & 1 deletion reference/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Follow these best practices to secure your API keys:
api.video limits the number of accepted API requests **per minute**. The limitation that the API applies to your calls depends on these factors:

* the [API environment](https://docs.api.video/reference#environments) you send your calls in
* your [pricing plan](https://api.video/pricing)
* your [pricing plan](https://api.video/pricing/)
* the request method that your calls use

| | Sandbox | Production |
Expand Down
2 changes: 1 addition & 1 deletion reference/uploaded-file-multiple-files.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ You can't attach multiple videos to the same upload request. One video or chunk

### Tutorials

* [Private video upload with a public token](https://api.video/blog/product-updates/video-access-management-how-to-create-deliver-and-manage-private-videos-and-what//)
* [Private video upload with a public token](https://api.video/blog/product-updates/video-access-management-how-to-create-deliver-and-manage-private-videos-and-what/)
* [Video upload](https://api.video/blog/tutorials/video-upload-tutorial/)

### Tools
Expand Down
2 changes: 1 addition & 1 deletion sdks/player/apivideo-android-player.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ a video Id to use this component and play a video from api.video. To get yours,
1. [Log into your account](https://dashboard.api.video/login) or create
one [here](https://dashboard.api.video/register).
2. Copy your API key (sandbox or production if you are subscribed to one of
our [plan](https://api.video/pricing)).
our [plan](https://api.video/pricing/)).
3. Go to [the official api.video documentation](https://docs.api.video/).
4. Go to API Reference -> Videos -> [List all videos](https://docs.api.video/reference/api/Videos#list-all-video-objects)
5. Create a `get` request to the `/videos` endpoint based on the reference, using a tool like Postman.
Expand Down
4 changes: 2 additions & 2 deletions sdks/player/apivideo-player-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,8 +93,8 @@ The PlayerSdk constructor takes 2 parameters:
| Option name | Mandatory | Type | Description |
| -------------: | --------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | **yes** | string | the id of the video (videoId or liveStreamId) |
| token | yes for private video | string | the [private video](https://api.video/blog/tutorials/tutorial-private-videos/) url token |
| privateSession | no | string | the [private video](https://api.video/blog/tutorials/tutorial-private-videos/) session id if needed |
| token | yes for private video | string | the [private video](https://api.video/blog/product-updates/video-access-management-how-to-create-deliver-and-manage-private-videos-and-what/) url token |
| privateSession | no | string | the [private video](https://api.video/blog/product-updates/video-access-management-how-to-create-deliver-and-manage-private-videos-and-what/) session id if needed |
| live | no (default: false) | boolean | indicate that the video is a live one |
| autoplay | no (default: false) | boolean | start playing the video as soon as it is loaded |
| muted | no (default: false) | boolean | the video is muted |
Expand Down
2 changes: 1 addition & 1 deletion sdks/player/apivideo-react-player.md
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ Example

#### Private videos

To play a [private video](https://api.video/blog/tutorials/tutorial-private-videos/), add the video view token in the video attribute:
To play a [private video](https://api.video/blog/product-updates/video-access-management-how-to-create-deliver-and-manage-private-videos-and-what/), add the video view token in the video attribute:

```tsx
// ...
Expand Down
2 changes: 1 addition & 1 deletion sdks/player/apivideo-swift-player.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ a video Id to use this component and play a video from api.video. To get yours,
1. [Log into your account](https://dashboard.api.video/login) or create
one [here](https://dashboard.api.video/register).
2. Copy your API key (sandbox or production if you are subscribed to one of
our [plan](https://api.video/pricing)).
our [plan](https://api.video/pricing/)).
3. Go to [the official api.video documentation](https://docs.api.video/).
4. Go to API Reference -> Videos -> [List all videos](https://docs.api.video/reference/api/Videos#list-all-video-objects)
5. Create a `get` request to the `/videos` endpoint based on the reference, using a tool like Postman.
Expand Down
4 changes: 2 additions & 2 deletions vod/clip-a-video.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ meta:

In some cases, you just need to upload a smaller piece of a video, but you would like to do that programmatically, without resorting to editing programs.

[api.video](http://api.video) allows you to clip a video to upload only specific parts of the video. You will be able to specify the start and end time of the clip before you upload the source video to api.video.
[api.video](https://api.video) allows you to clip a video to upload only specific parts of the video. You will be able to specify the start and end time of the clip before you upload the source video to api.video.

<Image src="/_assets/vod/video-clip/video-clipping-light.svg" src_dark="/_assets/vod/video-clip/video-clipping-dark.svg" alt="A diagram that shows the process of clipping a video" />

Expand All @@ -18,7 +18,7 @@ The videos are clipped by the definition of the object. When you create a video

## Usage

You can use one of the API clients offered by [api.video](http://api.video). You can find the list of clients in the [api.video API Client catalog](https://docs.api.video/sdks/api-clients).
You can use one of the API clients offered by [api.video](https://api.video). You can find the list of clients in the [api.video API Client catalog](https://docs.api.video/sdks/api-clients).

You can also find more information on the `/videos` endpoints on the [API reference page](https://docs.api.video/reference/api/Videos#create-a-video-object).

Expand Down
10 changes: 5 additions & 5 deletions vod/encoding-transcoding.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,16 @@ meta:
description: This guide explains what video encoding and transcoding means and how api.video enables you to provide your users high quality videos via encoding and transcoding.
---

## Encoding
# Encoding

The term encoding is used to describe the process of converting content into a different form. In the context of video - encoding technically only happens when the video is being recorded, and taken from the camera's raw format and saved into a [codec](https://api.video/what-is/codec/). Any further manipulations of the video file (say changing the format, or changing compression values) is transcoding. But, in practice, these two terms are used interchangeably to describe the process of converting a video file from one format to another.

### Why encode a video?
## Why encode a video?
Video files are inherently large, so using a codec to compress the video ensures that the file will be much smaller. As codecs get better at compression, we are able to transmit higher quality video for the same amount of data. For that reason, there is a lot of research into new codecs.

There are other considerations to undertake when choosing how to encode your video. The [H264](https://api.video/what-is/h-264/), while older and not the best compression, does support the highest browser support - making it a common encoding choice. Newer codecs like [H265](https://api.video/what-is/h-265/), VP9, and AVIF have better compression, but suffer slightly in the realm of browser support for playback.

### Encoding settings
## Encoding settings
When using a tool like FFMPEG, you can set the video quality. This determines how much compression there will be/how good the video will look. Higher compression leads to smaller files, but also higher [loss](https://api.video/what-is/lossy-compression/). FFMPEG uses the Constant Rate Factor for encoding quality (values of 0 are lossless, 51 is high compression.) The default value for CRF is 23, and generally creates a video that offers a high compression/quality ratio:

```
Expand All @@ -28,15 +28,15 @@ Every video uploaded to api.video is encoded/transcoded into an H264 MP4 and an

Transcoding is the process of taking already encoded (or transcoded) content, decompressing it and then using different codecs to alter or recompress it. It's labor intensive because you are taking every part of your video and audio and recompressing it. During this process, depending on what codecs you use, you may lose data.

### What types of transcoding are there?
## What types of transcoding are there?

There are three types of transcoding you will encounter:

- Lossy-to-lossy - This is where you take a codec that is lossy and transcode to another format that uses a lossy codec. You will lose lots of data during this process, and transcoding will lower the quality of your video.
- Lossless-to-lossy - This is where you take a codec that preserves every detail of a video and transfer it to one that loses data. The trade off results in something useful like faster decompression for playback, or a smaller file.
- Lossy-to-lossless - You cannot regain lost quality, so when transcoding in this situation, you retain all the data that was in the lossy compression without further degradation of the file.

### What are the goals of transcoding?
## What are the goals of transcoding?
The goals of transcoding are dependent upon your use case. The main reason to transcode video is because you want to use it in a new scenario with a codec that's optimized for that new scenario. For example, say you want to edit a video. You would probably want a codec that's good quality, but which lets you easily move backwards and forwards through the video so you can quickly find the parts of the video you want to clip and edit. A great example of a codec for this purpose would be ProRes. This codec doesn't work for playback with a lot of devices though. So after you're done editing, you would want to transcode to another codec that works for playback.

Other scenarios might be something like wanting to store a video for later use. When you store a video, if it's for a project, you might want to store the highest quality possible. Then when you get the video out later to edit again or use in a project, it's got as much information available as possible. Or, maybe you're storing a video just for reference purposes and you don't have a lot of space. Then you might want a codec that compresses efficiently but the video quality is lower. That would be enough for reference later.
Expand Down
18 changes: 9 additions & 9 deletions vod/video-download.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,27 +6,27 @@ meta:

# Video Download

After videos have been transcoded on [api.video](http://api.video), it’s natural that you want to give your users the ability to download their videos, or just download the video for your own use, possibly for backup.
After videos have been transcoded on [api.video](https://api.video), it’s natural that you want to give your users the ability to download their videos, or just download the video for your own use, possibly for backup.

[api.video](http://api.video) allows you and your users to download videos directly from the player or programmatically through the API.
[api.video](https://api.video) allows you and your users to download videos directly from the player or programmatically through the API.

<Image src="/_assets/vod/video-download/video-download-diagram-light.svg" src_dark="/_assets/vod/video-download/video-download-diagram-dark.svg" alt="A diagram that shows the process of video download" />

## Download a video from [api.video](http://api.video) player
## Download a video from [api.video](https://api.video) player

The video object can be created or updated with the `mp4Support` tag. The tag will make the video downloadable and display a button on the [api.video](http://api.video) player.
The video object can be created or updated with the `mp4Support` tag. The tag will make the video downloadable and display a button on the [api.video](https://api.video) player.

![](/_assets/vod/video-download/download-video-1.png)
![](/_assets/vod/video-download/download-video-2.png)

<Callout pad="2" type="info">
* By default, the `mp4Support` tag is set to `true`, hence the video is downloadable. If you want to disable the download ability from the [api.video](http://api.video) player, you have to set the `mp4Support` tag to `false`
* By default, the `mp4Support` tag is set to `true`, hence the video is downloadable. If you want to disable the download ability from the [api.video](https://api.video) player, you have to set the `mp4Support` tag to `false`
* If you don’t want the user to be able to download the video, do not serve the mp4 asset.
</Callout>

## Disabling download

You can use one of the API clients offered by [api.video](http://api.video). You can find the list of clients in the [api.video API Client catalog](https://docs.api.video/sdks/api-clients).
You can use one of the API clients offered by [api.video](https://api.video). You can find the list of clients in the [api.video API Client catalog](https://docs.api.video/sdks/api-clients).

You can also find more information on the `/videos` endpoints on the [API reference page](https://docs.api.video/reference/api/Videos#create-a-video-object).

Expand Down Expand Up @@ -347,7 +347,7 @@ func main() {

Most players support download, however, if you would like to add a download button to a custom player that doesn’t have a download button, it’s also possible.

By leveraging the API, you can create a request to [api.video](http://api.video), which will get the video id and then render a download button serving the mp4 asset.
By leveraging the API, you can create a request to [api.video](https://api.video), which will get the video id and then render a download button serving the mp4 asset.

In this example, you will learn how to create a custom download button with React and Node.js backend

Expand Down Expand Up @@ -384,7 +384,7 @@ const serverHostname = "localhost:5500"
const handleClick = async (sourceVideoId) => {
try {
// replace the server hostname with your
const response = await fetch(`http://${serverHostname}/download?videoId=${sourceVideoId}`, {
const response = await fetch(`https://${serverHostname}/download?videoId=${sourceVideoId}`, {
method: 'GET',
});
if (!response.ok) {
Expand Down Expand Up @@ -473,7 +473,7 @@ $ npm init
Now edit the index.js file that you’ve created, and copy this code.

<Callout pad="2" type="info">
Make sure that you copy your API key from the [api.video](http://api.video) dashboard and replace the port to the port you would like to run the server on.
Make sure that you copy your API key from the [api.video](https://api.video) dashboard and replace the port to the port you would like to run the server on.
</Callout>


Expand Down

0 comments on commit 8d36d83

Please sign in to comment.