YouTube Members API

The Members API from YouTube — 1 operation(s) for members.

GitHub OpenAPI

Operations 1

GET /youtube/v3/members List members #

Documentation

📖
Documentation
https://developers.google.com/youtube/v3/docs/activities/list
📖
GettingStarted
https://developers.google.com/youtube/v3/getting-started
📖
Authentication
https://developers.google.com/youtube/v3/guides/authentication
📖
Documentation
https://developers.google.com/youtube/v3/docs/channels/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/comments/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/commentThreads/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/playlists/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/playlistItems/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/search/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/subscriptions/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/videos/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/captions
📖
Documentation
https://developers.google.com/youtube/v3/docs/videoCategories
📖
Documentation
https://developers.google.com/youtube/v3/docs/i18nLanguages
📖
Documentation
https://developers.google.com/youtube/v3/docs/i18nRegions
📖
Documentation
https://developers.google.com/youtube/analytics
📖
GettingStarted
https://developers.google.com/youtube/reporting/guides/authorization
📖
APIReference
https://developers.google.com/youtube/analytics/reference
📖
Authentication
https://developers.google.com/youtube/reporting/guides/authorization
📖
Documentation
https://developers.google.com/youtube/reporting
📖
APIReference
https://developers.google.com/youtube/reporting/v1/reference/rest
📖
Documentation
https://developers.google.com/youtube/reporting/v1/reports
📖
GettingStarted
https://developers.google.com/youtube/v3/live/getting-started
📖
Documentation
https://developers.google.com/youtube/v3/live/docs
📖
APIReference
https://developers.google.com/youtube/v3/live/docs

Specifications

Code Examples

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/youtube:youtube-members-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

youtube-members-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: YouTube Data API v3 Members API
  version: v3
  description: Generated from Google's published Discovery document for YouTube Data API v3 (youtube v3, revision 20261111). 1 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://youtube.googleapis.com
tags:
- name: Members
paths:
  /youtube/v3/members:
    get:
      operationId: youtube.members.list
      summary: List members
      description: Retrieves a list of members that match the request criteria for a channel.
      parameters:
      - name: filterByMemberChannelId
        in: query
        required: false
        description: Comma separated list of channel IDs. Only data about members that are part of this list will be included in the response.
        schema:
          type: string
      - name: hasAccessToLevel
        in: query
        required: false
        description: Filter members in the results set to the ones that have access to a level.
        schema:
          type: string
      - name: maxResults
        in: query
        required: false
        description: The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
        schema:
          type: integer
          maximum: 1000
          minimum: 0
          format: uint32
          default: '5'
      - name: mode
        in: query
        required: false
        description: Parameter that specifies which channel members to return.
        schema:
          enum:
          - listMembersModeUnknown
          - updates
          - all_current
          type: string
          default: all_current
      - name: pageToken
        in: query
        required: false
        description: 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.
        schema:
          type: string
      - name: part
        in: query
        required: true
        description: The *part* parameter specifies the member resource parts that the API response will include. Set the parameter value to snippet.
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberListResponse'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/youtube.channel-memberships.creator
      - apiKey: []
      tags:
      - Members
components:
  schemas:
    MembershipsDetails:
      properties:
        accessibleLevels:
          description: Ids of all levels that the user has access to. This includes the currently active level and all other levels that are included because of a higher purchase.
          items:
            type: string
          type: array
        membershipsDuration:
          $ref: '#/components/schemas/MembershipsDuration'
          description: Data about memberships duration without taking into consideration pricing levels.
        highestAccessibleLevelDisplayName:
          description: Display name for the highest level that the user has access to at the moment.
          type: string
        highestAccessibleLevel:
          type: string
          description: Id of the highest level that the user has access to at the moment.
        membershipsDurationAtLevels:
          description: Data about memberships duration on particular pricing levels.
          items:
            $ref: '#/components/schemas/MembershipsDurationAtLevel'
          type: array
      type: object
    PageInfo:
      description: Paging details for lists of resources, including total number of items available and number of resources returned in a single page.
      properties:
        resultsPerPage:
          format: int32
          description: The number of results included in the API response.
          type: integer
        totalResults:
          description: The total number of results in the result set.
          type: integer
          format: int32
      type: object
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    MemberSnippet:
      type: object
      properties:
        memberDetails:
          $ref: '#/components/schemas/ChannelProfileDetails'
          description: Details about the member.
        membershipsDetails:
          $ref: '#/components/schemas/MembershipsDetails'
          description: Details about the user's membership.
        creatorChannelId:
          description: The id of the channel that's offering memberships.
          type: string
    MembershipsDurationAtLevel:
      type: object
      properties:
        memberSince:
          type: string
          description: The date and time when the user became a continuous member for the given level.
        level:
          description: Pricing level ID.
          type: string
        memberTotalDurationMonths:
          type: integer
          format: int32
          description: The cumulative time the user has been a member for the given level in complete months (the time is rounded down to the nearest integer).
    MembershipsDuration:
      properties:
        memberTotalDurationMonths:
          description: The cumulative time the user has been a member across all levels in complete months (the time is rounded down to the nearest integer).
          format: int32
          type: integer
        memberSince:
          description: The date and time when the user became a continuous member across all levels.
          type: string
      type: object
    MemberListResponse:
      properties:
        items:
          description: A list of members that match the request criteria.
          type: array
          items:
            $ref: '#/components/schemas/Member'
        visitorId:
          type: string
          description: The visitorId identifies the visitor.
          deprecated: true
        eventId:
          description: Serialized EventId of the request which produced this response.
          type: string
          deprecated: true
        nextPageToken:
          type: string
          description: The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.
        tokenPagination:
          $ref: '#/components/schemas/TokenPagination'
        pageInfo:
          $ref: '#/components/schemas/PageInfo'
        kind:
          type: string
          default: youtube#memberListResponse
          description: 'Identifies what kind of resource this is. Value: the fixed string "youtube#memberListResponse".'
        etag:
          description: Etag of this resource.
          type: string
      type: object
    Member:
      type: object
      properties:
        snippet:
          $ref: '#/components/schemas/MemberSnippet'
          description: The snippet object contains basic details about the member.
        kind:
          type: string
          description: 'Identifies what kind of resource this is. Value: the fixed string "youtube#member".'
          default: youtube#member
        etag:
          type: string
          description: Etag of this resource.
      description: A *member* resource represents a member for a YouTube channel. A member provides recurring monetary support to a creator and receives special benefits.
    TokenPagination:
      properties: {}
      description: Stub token pagination template to suppress results.
      type: object
    ChannelProfileDetails:
      properties:
        channelId:
          description: The YouTube channel ID.
          type: string
        displayName:
          description: The channel's display name.
          type: string
        channelUrl:
          description: The channel's URL.
          type: string
        profileImageUrl:
          type: string
          description: The channels's avatar URL.
      type: object
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/youtube: Manage your YouTube account
            https://www.googleapis.com/auth/youtubepartner: View and manage your assets and associated content on YouTube
            https://www.googleapis.com/auth/youtube.channel-memberships.creator: See a list of your current active channel members, their current level, and when they became a member
            https://www.googleapis.com/auth/youtubepartner-channel-audit: View private information of your YouTube channel relevant during the audit process with a YouTube partner
            https://www.googleapis.com/auth/youtube.force-ssl: See, edit, and permanently delete your YouTube videos, ratings, comments and captions
            https://www.googleapis.com/auth/youtube.readonly: View your YouTube account
            https://www.googleapis.com/auth/youtube.upload: Manage your YouTube videos
externalDocs:
  url: https://developers.google.com/youtube/
x-provenance:
  method: harvested
  publisher: Google
  source: https://youtube.googleapis.com/$discovery/rest?version=v3
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261111)