# getyoutubevideorating: Get YouTube Video Rating

> getyoutubevideorating (Get YouTube Video Rating) is a 1001fx API function in the group YouTube: POST https://api.1001fx.com/youtube/getyoutubevideorating, 5 credits per call. It works in Make, n8n, scripts and AI agents as a plain HTTP call.

**Deprecated:** this function will be removed in a future release.

Retrieves the ratings that the authorized user gave to a list of specified videos.

- This service is provided by an external service provider: YouTube. The data of the call is sent to the provider. [More about service providers](https://1001fx.com/functions#serviceproviders)

- Group: YouTube
- Endpoint: `POST https://api.1001fx.com/youtube/getyoutubevideorating`
- Authentication: header `X-API-KEY: YOURSECRETAPIKEY`
- Content type: application/json
- Credits: 5 credits per call
- Ready-made in: none, use an HTTP request
- Service provider: YouTube
- Docs: https://1001fx.com/functions/getyoutubevideorating

## Parameters

- `credentialKey` (string, required) – 1001fx Credential Key: Your 1001fx credential key. See https://1001fx.com/app/credentials/list
- `videoIds` (array<string>, optional) – Video IDs: The videoIds parameter specifies a comma-separated list of the YouTube video ID(s) for the resource(s) that are being retrieved. In a video resource, the id property specifies the videos ID.

## Example: Get YouTube Video Rating

```bash
curl -X POST 'https://api.1001fx.com/youtube/getyoutubevideorating' \
  -H 'X-API-KEY: YOURSECRETAPIKEY' \
  -H 'Content-Type: application/json' \
  -d '{"credentialKey":"yourCredentialKey","videoIds":["kJQP7kiw5Fk","JGwWNGJdvx8"]}'
```
