List YouTube Channel Monitors
/v1/youtube/monitorsLists YouTube channel monitors configured for public platform monitoring.
On this page
Request example
Replace placeholders with your values. Use your Team API key for authenticated requests.
https://kieapi.comcurl -G "https://kieapi.com/v1/youtube/monitors" \
-H "Authorization: Bearer $SPIDER_API_KEY" \
--data-urlencode 'limit=20'Authentication
BearerAuth
Parameters
limitquery · integerDefault:
20Minimum: 1
Maximum: 100
cursorquery · string | null
Responses
200 YouTube monitor page.
application/json
itemsarray of YoutubeMonitor requirednext_cursorstring | null
401 Missing or invalid API key.
403 Authenticated principal cannot access this resource.
429 Temporary rate limit.
503 Required runtime service is unavailable.
Schemas
Field definitions and complete validation rules for this API. Follow a type link to its definition.
YoutubeMonitorListResponse
object
itemsarray of YoutubeMonitor requirednext_cursorstring | null
Complete schema
{
"type": "object",
"additionalProperties": false,
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/YoutubeMonitor"
}
},
"next_cursor": {
"type": [
"string",
"null"
]
}
}
}YoutubeMonitor
object
idstring requiredplatformstring requiredAllowed:
"youtube"statusstring requiredAllowed:
"active", "paused"strategyYoutubeMonitorStrategy requiredtargetYoutubeMonitorTarget requiredsettingsYoutubeMonitorSettings requiredchecksarray of YoutubeMonitorCheckState requiredcreated_atstring | null (date-time)updated_atstring | null (date-time)
Complete schema
{
"type": "object",
"additionalProperties": false,
"required": [
"id",
"platform",
"status",
"strategy",
"target",
"settings",
"checks"
],
"properties": {
"id": {
"type": "string"
},
"platform": {
"type": "string",
"enum": [
"youtube"
]
},
"status": {
"type": "string",
"enum": [
"active",
"paused"
]
},
"strategy": {
"$ref": "#/components/schemas/YoutubeMonitorStrategy"
},
"target": {
"$ref": "#/components/schemas/YoutubeMonitorTarget"
},
"settings": {
"$ref": "#/components/schemas/YoutubeMonitorSettings"
},
"checks": {
"type": "array",
"items": {
"$ref": "#/components/schemas/YoutubeMonitorCheckState"
}
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updated_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
}YoutubeMonitorStrategy
string
Complete schema
{
"type": "string",
"enum": [
"rss",
"yt_dlp_polling",
"auto"
]
}YoutubeMonitorTarget
object
channel_idstring | nullchannel_urlstring | nullrss_urlstring | null
Complete schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"channel_id": {
"type": [
"string",
"null"
]
},
"channel_url": {
"type": [
"string",
"null"
]
},
"rss_url": {
"type": [
"string",
"null"
]
}
}
}YoutubeMonitorSettings
object
check_interval_secondsnumber requiredslow_check_interval_secondsnumber requiredmax_itemsinteger requiredquiet_first_checkboolean requiredquiet_startboolean requiredtrack_rescheduleboolean required
Complete schema
{
"type": "object",
"additionalProperties": false,
"required": [
"check_interval_seconds",
"slow_check_interval_seconds",
"max_items",
"quiet_first_check",
"quiet_start",
"track_reschedule"
],
"properties": {
"check_interval_seconds": {
"type": "number"
},
"slow_check_interval_seconds": {
"type": "number"
},
"max_items": {
"type": "integer"
},
"quiet_first_check": {
"type": "boolean"
},
"quiet_start": {
"type": "boolean"
},
"track_reschedule": {
"type": "boolean"
}
}
}YoutubeMonitorCheckState
object
strategyYoutubeMonitorBackendStrategy requiredstatusstring requiredAllowed:
"never_run", "completed", "failed", "not_modified"next_check_atstring | null (date-time)last_checked_atstring | null (date-time)last_error_codestring | null
Complete schema
{
"type": "object",
"additionalProperties": false,
"required": [
"strategy",
"status"
],
"properties": {
"strategy": {
"$ref": "#/components/schemas/YoutubeMonitorBackendStrategy"
},
"status": {
"type": "string",
"enum": [
"never_run",
"completed",
"failed",
"not_modified"
]
},
"next_check_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"last_checked_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"last_error_code": {
"type": [
"string",
"null"
]
}
}
}YoutubeMonitorBackendStrategy
string
Complete schema
{
"type": "string",
"enum": [
"rss",
"yt_dlp_polling"
]
}PublicErrorResponse
object
errorPublicError required
Complete schema
{
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"$ref": "#/components/schemas/PublicError"
}
}
}PublicError
object
codestring requiredAllowed:
"seoapi_price_pending", "seoapi_unavailable", "seoapi_busy", "seoapi_not_found", "seoapi_rate_limited", "seoapi_budget_exceeded", "seoapi_idempotency_conflict", "seoapi_insufficient_credits", "seoapi_admission_failed", "seoapi_execution_interrupted", "seoapi_delivery_unknown", "seoapi_response_invalid", "seoapi_model_unsupported", "seoapi_model_options_invalid", "seoapi_provider_rejected", "seo_price_pending", "seo_provider_blocked", "seo_local_rate_limited", "seo_fallback_unavailable", "seo_fallback_budget_exceeded", "seo_pagination_expired", "seo_delivery_uncertain", "seo_auth_required", "seo_initialization_required", "seo_permission_denied", "seo_verification_required", "seo_rate_limited", "seo_upstream_unavailable", "seo_transport_failed", "seo_invalid_response", "seo_rpc_error", "seo_period_unavailable", "seo_account_unavailable", "seo_session_busy", "seo_configuration_required", "validation_error", "invalid_request", "unsupported_feature", "authentication_required", "permission_denied", "not_found", "run_not_found", "crawl_not_found", "artifact_not_found", "session_not_found", "profile_not_found", "profile_in_use", "profile_not_ready", "profile_not_cloneable", "profile_limit_reached", "profile_proxy_conflict", "proxy_not_found", "proxy_unavailable", "invalid_session_options", "invalid_query_options", "invalid_cursor", "idempotency_key_required", "browser_session_limit_reached", "browser_capacity_exhausted", "browser_start_timeout", "browser_runtime_unavailable", "session_not_active", "controller_already_connected", "browser_relay_unavailable", "precondition_required", "precondition_failed", "timeout", "run_not_ready", "artifact_expired", "quota_exceeded", "insufficient_credits", "billing_reconciliation_required", "rate_limited", "fetch_failed", "render_failed", "maps_rate_limited", "maps_challenge", "maps_schema_changed", "maps_invalid_response", "maps_transport_failed", "maps_page_budget_exhausted", "google_trends_rate_limited", "google_trends_challenge", "google_trends_explore_failed", "google_trends_widget_missing", "google_trends_related_failed", "google_trends_invalid_response", "google_trends_transport_failed", "google_trends_collection_failed", "google_ads_account_context_missing", "google_ads_batch_failed", "google_ads_browser_context_missing", "google_ads_browser_unavailable", "google_ads_collection_failed", "google_ads_page_failed", "google_ads_protocol_drift", "google_ads_rate_limited", "google_ads_timeout", "twitter_provider_unavailable", "twitter_provider_rejected", "twitter_submission_unknown", "wechat_transport_failed", "wechat_rate_limited", "wechat_invalid_response", "wechat_redirect_rejected", "wechat_verification_required", "wechat_parse_failed", "blackhatworld_search_failed", "blackhatworld_no_results", "reddit_read_failed", "idempotency_conflict", "idempotency_in_progress", "service_unavailable", "internal_error"messagestring requiredtypestring requiredAllowed:
"auth", "validation", "quota", "rate_limit", "not_found", "execution", "conflict", "internal"retryableboolean requiredrequest_idstring | nulldetailsobject
Complete schema
{
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"type",
"retryable"
],
"properties": {
"code": {
"type": "string",
"enum": [
"seoapi_price_pending",
"seoapi_unavailable",
"seoapi_busy",
"seoapi_not_found",
"seoapi_rate_limited",
"seoapi_budget_exceeded",
"seoapi_idempotency_conflict",
"seoapi_insufficient_credits",
"seoapi_admission_failed",
"seoapi_execution_interrupted",
"seoapi_delivery_unknown",
"seoapi_response_invalid",
"seoapi_model_unsupported",
"seoapi_model_options_invalid",
"seoapi_provider_rejected",
"seo_price_pending",
"seo_provider_blocked",
"seo_local_rate_limited",
"seo_fallback_unavailable",
"seo_fallback_budget_exceeded",
"seo_pagination_expired",
"seo_delivery_uncertain",
"seo_auth_required",
"seo_initialization_required",
"seo_permission_denied",
"seo_verification_required",
"seo_rate_limited",
"seo_upstream_unavailable",
"seo_transport_failed",
"seo_invalid_response",
"seo_rpc_error",
"seo_period_unavailable",
"seo_account_unavailable",
"seo_session_busy",
"seo_configuration_required",
"validation_error",
"invalid_request",
"unsupported_feature",
"authentication_required",
"permission_denied",
"not_found",
"run_not_found",
"crawl_not_found",
"artifact_not_found",
"session_not_found",
"profile_not_found",
"profile_in_use",
"profile_not_ready",
"profile_not_cloneable",
"profile_limit_reached",
"profile_proxy_conflict",
"proxy_not_found",
"proxy_unavailable",
"invalid_session_options",
"invalid_query_options",
"invalid_cursor",
"idempotency_key_required",
"browser_session_limit_reached",
"browser_capacity_exhausted",
"browser_start_timeout",
"browser_runtime_unavailable",
"session_not_active",
"controller_already_connected",
"browser_relay_unavailable",
"precondition_required",
"precondition_failed",
"timeout",
"run_not_ready",
"artifact_expired",
"quota_exceeded",
"insufficient_credits",
"billing_reconciliation_required",
"rate_limited",
"fetch_failed",
"render_failed",
"maps_rate_limited",
"maps_challenge",
"maps_schema_changed",
"maps_invalid_response",
"maps_transport_failed",
"maps_page_budget_exhausted",
"google_trends_rate_limited",
"google_trends_challenge",
"google_trends_explore_failed",
"google_trends_widget_missing",
"google_trends_related_failed",
"google_trends_invalid_response",
"google_trends_transport_failed",
"google_trends_collection_failed",
"google_ads_account_context_missing",
"google_ads_batch_failed",
"google_ads_browser_context_missing",
"google_ads_browser_unavailable",
"google_ads_collection_failed",
"google_ads_page_failed",
"google_ads_protocol_drift",
"google_ads_rate_limited",
"google_ads_timeout",
"twitter_provider_unavailable",
"twitter_provider_rejected",
"twitter_submission_unknown",
"wechat_transport_failed",
"wechat_rate_limited",
"wechat_invalid_response",
"wechat_redirect_rejected",
"wechat_verification_required",
"wechat_parse_failed",
"blackhatworld_search_failed",
"blackhatworld_no_results",
"reddit_read_failed",
"idempotency_conflict",
"idempotency_in_progress",
"service_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"auth",
"validation",
"quota",
"rate_limit",
"not_found",
"execution",
"conflict",
"internal"
]
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": [
"string",
"null"
]
},
"details": {
"type": "object",
"additionalProperties": true
}
}
}