Skip to content
Eden Engine

Douyin Video Mix (Playlist) Lookup (by Mix ID)

omnial/douyin-app-fetch-video-mix-detail

Given a Douyin video mix (playlist) id, returns that mix's own metadata: its name, description, cover art, creation/update timestamps, moderation/punishment status, play and collect counts, episode progress, share-card title/caption text, and the mix creator's public profile summary (display name, handle, avatar, verification status, follower/video counts). An invalid or nonexistent mix id returns a mostly-empty shell (no creator profile) rather than an error.

activeper callv1
Provider
Web & Business Data Network
Category
douyin
Provider price
$0.0020475 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "required": [
    "mix_id"
  ],
  "properties": {
    "mix_id": {
      "type": "string",
      "examples": [
        "7302011174286002217"
      ],
      "description": "Mix id"
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "mix_info": {
      "type": "object",
      "properties": {
        "desc": {
          "type": "string",
          "description": "Empty string on both fixtures observed."
        },
        "author": {
          "type": "object",
          "properties": {
            "uid": {
              "type": "string",
              "description": "The creator's public numeric account id."
            },
            "gender": {
              "type": "number"
            },
            "nickname": {
              "type": "string",
              "description": "The creator's public display name."
            },
            "short_id": {
              "type": "string",
              "description": "The creator's alternate public-facing numeric id."
            },
            "signature": {
              "type": "string",
              "description": "The creator's public bio text."
            },
            "unique_id": {
              "type": "string",
              "description": "The creator's public Douyin handle (may be empty if unset)."
            },
            "aweme_count": {
              "type": "number"
            },
            "is_verified": {
              "type": "boolean"
            },
            "avatar_larger": {
              "type": "object",
              "properties": {
                "uri": {
                  "type": "string"
                },
                "width": {
                  "type": "number"
                },
                "height": {
                  "type": "number"
                },
                "url_list": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "description": "The creator's avatar image URL(s). Value withheld (stripped) in this tool's output -- only whether an avatar exists is a given, not the image itself."
                }
              },
              "additionalProperties": true
            },
            "constellation": {
              "type": "number"
            },
            "custom_verify": {
              "type": "string"
            },
            "follower_count": {
              "type": "number"
            },
            "following_count": {
              "type": "number"
            },
            "total_favorited": {
              "type": "number"
            },
            "favoriting_count": {
              "type": "number"
            },
            "enterprise_verify_reason": {
              "type": "string",
              "description": "Public verification label shown on a verified enterprise account."
            }
          },
          "description": "The mix creator's public profile summary. Entirely absent on the nonexistent-id fixture -- confirmed against `invalid-mix-id.json`, whose `mix_info` carries no `author` key at all.",
          "additionalProperties": true
        },
        "is_iaa": {
          "type": "number"
        },
        "mix_id": {
          "type": "string",
          "description": "The mix id the caller supplied, echoed back by the endpoint."
        },
        "statis": {
          "type": "object",
          "properties": {
            "play_vv": {
              "type": "number"
            },
            "collect_vv": {
              "type": "number"
            },
            "current_episode": {
              "type": "number"
            },
            "last_read_episode": {
              "type": "number"
            },
            "updated_to_episode": {
              "type": "number"
            }
          },
          "description": "Engagement/reading-progress counters. All 0 on the not-found case.",
          "additionalProperties": true
        },
        "status": {
          "type": "object",
          "properties": {
            "status": {
              "type": "number",
              "description": "2 observed on the real mix, 0 on not-found."
            },
            "is_collected": {
              "type": "number"
            }
          },
          "additionalProperties": true
        },
        "mix_name": {
          "type": "string",
          "description": "The mix's own public title. Empty string observed on the nonexistent-id fixture."
        },
        "mix_type": {
          "type": "number"
        },
        "cover_url": {
          "type": "object",
          "properties": {
            "uri": {
              "type": "string"
            },
            "width": {
              "type": "number"
            },
            "height": {
              "type": "number"
            }
          },
          "additionalProperties": true
        },
        "share_info": {
          "type": "object",
          "properties": {
            "share_desc": {
              "type": "string"
            },
            "share_title": {
              "type": "string"
            },
            "share_desc_info": {
              "type": "string"
            },
            "share_weibo_desc": {
              "type": "string"
            },
            "share_title_other": {
              "type": "string"
            },
            "share_title_myself": {
              "type": "string"
            }
          },
          "description": "Douyin's own auto-generated share-card text. `share_desc`/`share_desc_info`/`share_weibo_desc` on both fixtures include the platform's own anti-scraping punctuation, which can visually resemble an email address (e.g. a stray `@`) but is not one -- see this tool's verification notes.",
          "additionalProperties": true
        },
        "create_time": {
          "type": "number",
          "description": "Unix seconds. 0 on the not-found case."
        },
        "update_time": {
          "type": "number",
          "description": "Unix seconds. 0 on the not-found case."
        },
        "mix_pic_type": {
          "type": "number"
        },
        "is_serial_mix": {
          "type": "number"
        },
        "paid_episodes": {
          "type": "null",
          "description": "Always observed `null` on both calibration fixtures; the vendor does not document a populated shape for this field."
        },
        "mix_punish_info": {
          "type": "object",
          "properties": {
            "reason": {
              "type": "string"
            },
            "jump_schema": {
              "type": "string"
            },
            "has_punished": {
              "type": "boolean"
            }
          },
          "description": "Moderation/punishment status for the mix.",
          "additionalProperties": true
        },
        "has_recommend_mix": {
          "type": "number"
        }
      },
      "description": "Present on both calibration fixtures, including the nonexistent-id case.",
      "additionalProperties": true
    }
  },
  "description": "The mix (playlist) record, as returned at routing.responseResultPath ($.output). On the `invalid-mix-id` fixture (a nonexistent mix id, still billed the normal per-call price), `mix_info` is still present but every field inside it is zeroed/blank and `mix_info.author` is entirely absent -- confirmed against that fixture.",
  "additionalProperties": true
}

Pricing

Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.

Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.

ChargeRate
Per call
Flat, regardless of what comes back
$0.0020475
Cost basis
Not recorded

This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.

Updated
Sep 23, 2026