List YouTube channel subscriptions
youtube.x.youtube-subscriptions-listsubscriptions.list — Retrieves a list of resources, possibly filtered.
- Price
- freeAl precio del proveedor
- Success rate
- —Aún no hay datos de tasa de éxitoAún no hay datos de tasa de éxito
- Latency p50
- ——
- Last verified
- —Not verified yet
GEThttps://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-listPreview- Uses platform quota
- Synchronous response
- Reads public data
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
id | cadena | Opcional | Return the subscriptions with the given IDs for Stubby or Apiary. | |
mine | booleano | Opcional | Flag for returning the subscriptions of the authenticated user. | |
part | cadena | Obligatorio | The *part* parameter specifies a comma-separated list of one or more subscription resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a subscription resou | |
order | cadena | Opcional | The order of the returned subscriptions | |
channelId | cadena | Opcional | Return the subscriptions of the given channel owner. | |
pageToken | cadena | Opcional | The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved. | |
maxResults | entero | Opcional | The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. | |
forChannelId | cadena | Opcional | Return the subscriptions to the subset of these channels that the authenticated user is subscribed to. | |
mySubscribers | booleano | Opcional | Return the subscribers of the given channel owner. | |
myRecentSubscribers | booleano | Opcional | ||
onBehalfOfContentOwner | cadena | Opcional | *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is inte | |
onBehalfOfContentOwnerChannel | cadena | Opcional | This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required whe | |
- Parámetros de consulta
idcadenaOpcionalReturn the subscriptions with the given IDs for Stubby or Apiary.
minebooleanoOpcionalFlag for returning the subscriptions of the authenticated user.
partcadenaObligatorioThe *part* parameter specifies a comma-separated list of one or more subscription resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a subscription resou
ordercadenaOpcionalThe order of the returned subscriptions
channelIdcadenaOpcionalReturn the subscriptions of the given channel owner.
pageTokencadenaOpcionalThe *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
maxResultsenteroOpcionalThe *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
forChannelIdcadenaOpcionalReturn the subscriptions to the subset of these channels that the authenticated user is subscribed to.
mySubscribersbooleanoOpcionalReturn the subscribers of the given channel owner.
myRecentSubscribersbooleanoOpcionalonBehalfOfContentOwnercadenaOpcional*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is inte
onBehalfOfContentOwnerChannelcadenaOpcionalThis parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required whe
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
curl -X GET 'https://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-list' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-list",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-list", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a free, incluida la tarifa de servicio.