# Similar Channels

**Use case:** 

This task searches the topic `similar channels` with focused breadth and a maximum of 10 candidates. The overview dataset lists first eligible public YouTube channel matches with similarity scores, discovery input, channel URLs, public profile data, audience metrics, topic keywords, and YouTube related-channel status.

## Input

```json
{
  "discoveryMethod": "topic",
  "channelReferences": [
    "https://www.youtube.com/@Google",
    "@NASA",
    "UC_x5XG1OV2P6uZZ5FSM9Ttw"
  ],
  "topicQuery": "similar channels",
  "resultBreadth": "focused",
  "maxItems": 10,
  "filters": {
    "minSubscribers": 1000,
    "countries": [
      "US"
    ],
    "verification": "any",
    "familyFriendliness": "any",
    "publicEmail": "hasEmail",
    "monetization": "any",
    "sponsorship": "any"
  }
}
```

## Output

```json
{
  "discoveryMethod": {
    "label": "Discovery method",
    "format": "string"
  },
  "discoveryInput": {
    "label": "Discovery input",
    "format": "string"
  },
  "channelId": {
    "label": "Channel ID",
    "format": "string"
  },
  "channelName": {
    "label": "Channel name",
    "format": "string"
  },
  "channelUrl": {
    "label": "Channel URL",
    "format": "string"
  },
  "similarityScore": {
    "label": "Similarity score",
    "format": "number"
  },
  "topicKeywords": {
    "label": "Topic keywords",
    "format": "array"
  },
  "youtubeRelatedStatus": {
    "label": "YouTube related result",
    "format": "string"
  },
  "youtubeRelatedRank": {
    "label": "YouTube related rank",
    "format": "integer"
  },
  "subscribers": {
    "label": "Subscribers",
    "format": "integer"
  },
  "totalViews": {
    "label": "Total views",
    "format": "integer"
  },
  "publishedVideos": {
    "label": "Published videos",
    "format": "integer"
  },
  "averageVideoViews": {
    "label": "Average video views",
    "format": "integer"
  },
  "averageShortsViews": {
    "label": "Average Shorts views",
    "format": "integer"
  },
  "description": {
    "label": "Channel description",
    "format": "string"
  },
  "avatarUrl": {
    "label": "Avatar URL",
    "format": "string"
  },
  "bannerUrl": {
    "label": "Banner URL",
    "format": "string"
  },
  "country": {
    "label": "Country",
    "format": "string"
  },
  "createdDate": {
    "label": "Created date",
    "format": "string"
  },
  "tags": {
    "label": "Channel tags",
    "format": "array"
  },
  "creatorType": {
    "label": "Creator type",
    "format": "string"
  },
  "gender": {
    "label": "Gender",
    "format": "string"
  },
  "language": {
    "label": "Primary language",
    "format": "string"
  },
  "isVerified": {
    "label": "Verified",
    "format": "boolean"
  },
  "isFamilyFriendly": {
    "label": "Family friendly",
    "format": "boolean"
  },
  "hasPublicEmail": {
    "label": "Has public email",
    "format": "boolean"
  },
  "isMonetized": {
    "label": "Monetized",
    "format": "boolean"
  },
  "hasSponsorship": {
    "label": "Has sponsorship",
    "format": "boolean"
  }
}
```

## About this Actor

This example demonstrates how to use [YouTube Similar Channels Finder](https://apify.com/maximedupre/youtube-similar-channels.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/maximedupre/youtube-similar-channels.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/maximedupre/youtube-similar-channels.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).