Skip to content
Eden Engine

Douyin Creator Conversion Report (by Author ID)

omnial/douyin-xingtu-get-author-convert-videos-or-products

Given a Douyin creator's author ID, returns their conversion report: per-video performance metrics (click rate, revenue per thousand views, pay amount) and each video's engagement counts (watch, like, comment, favorite, share), plus pagination. Requesting the products branch returns an empty result (no `video_list`) for a creator with no product conversions, still billed at the normal per-call price.

activeper callv1
Provider
Web & Business Data Network
Category
douyin
Provider price
$0.004095 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": [
    "o_author_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "examples": [
        1
      ],
      "description": "Page number"
    },
    "time_range": {
      "type": "integer",
      "default": 2,
      "examples": [
        2
      ],
      "description": "Time range tier, default 2"
    },
    "detail_type": {
      "type": "integer",
      "default": 1,
      "examples": [
        1
      ],
      "description": "Detail type, 1=videos, 2=products"
    },
    "industry_id": {
      "type": "integer",
      "default": 0,
      "description": "Industry ID, 0=unlimited"
    },
    "o_author_id": {
      "type": "string",
      "examples": [
        "7589271892177518598"
      ],
      "description": "Creator ID"
    },
    "platform_source": {
      "type": "integer",
      "default": 1,
      "examples": [
        1
      ],
      "description": "Platform source"
    },
    "platform_channel": {
      "type": "integer",
      "default": 1,
      "examples": [
        1
      ],
      "description": "Platform channel"
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "base_resp": {
      "type": "object",
      "properties": {
        "status_code": {
          "type": "number",
          "description": "0 on every successful call observed."
        },
        "status_message": {
          "type": "string",
          "description": "Empty string on every successful call observed."
        }
      },
      "description": "Status shell. `status_code` 0 with empty `status_message` on both fixtures observed.",
      "additionalProperties": true
    },
    "pagination": {
      "type": "object",
      "properties": {
        "page": {
          "type": "number",
          "description": "1-based page number."
        },
        "limit": {
          "type": "number",
          "description": "Page size (10 observed)."
        },
        "has_more": {
          "type": "boolean"
        },
        "total_count": {
          "type": "number"
        }
      },
      "description": "Page metadata. `total_count` 0 on the empty products branch, 1 on the populated video branch.",
      "additionalProperties": true
    },
    "video_list": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "gpm": {
            "type": "string",
            "description": "Revenue per thousand views, as a numeric string."
          },
          "gpm_range": {
            "type": "string",
            "description": "Revenue-per-thousand range tier, as a numeric string."
          },
          "click_rate": {
            "type": "number",
            "description": "0 on the one video observed."
          },
          "item_stats": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Numeric video id, as a numeric string -- matches the id in the video's withheld share URL."
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The video's share URL. Value withheld (stripped to `null`) in this tool's output -- the raw value is a share link carrying tracking parameters and must not reach a customer."
              },
              "stats": {
                "type": "object",
                "properties": {
                  "like_cnt": {
                    "type": "string",
                    "description": "Like count, as a numeric string."
                  },
                  "share_cnt": {
                    "type": "string",
                    "description": "Share count, as a numeric string."
                  },
                  "watch_cnt": {
                    "type": "string",
                    "description": "Watch/play count, as a numeric string."
                  },
                  "comment_cnt": {
                    "type": "string",
                    "description": "Comment count, as a numeric string."
                  },
                  "finish_rate": {
                    "type": "number",
                    "description": "Completion rate fraction, 0-1."
                  },
                  "favorite_cnt": {
                    "type": "string",
                    "description": "Favorite count, as a numeric string."
                  },
                  "interact_rate": {
                    "type": "number",
                    "description": "Interaction rate fraction."
                  },
                  "avg_watch_dura": {
                    "type": "string",
                    "description": "Average watch duration in seconds, as a numeric string."
                  }
                },
                "description": "Engagement counters for the video.",
                "additionalProperties": true
              },
              "title": {
                "type": "string",
                "description": "The video's public title -- content the creator chose to publish openly on the platform."
              },
              "duration": {
                "type": "number",
                "description": "Video length in seconds."
              },
              "video_id": {
                "type": "string",
                "description": "The video's internal content id."
              },
              "author_id": {
                "type": "string",
                "description": "Numeric platform account id of the video's author, as a numeric string -- an opaque id, not a name, handle, or contact detail."
              },
              "cover_uri": {
                "type": "string",
                "description": "Cover image's storage path (a CDN object key, not a URL and not identity-bearing)."
              },
              "create_time": {
                "type": "string",
                "description": "Unix-seconds publish timestamp, as a numeric string."
              }
            },
            "description": "The video's own identifiers and engagement counters.",
            "additionalProperties": true
          },
          "industry_id": {
            "type": "number",
            "description": "Numeric industry category id."
          },
          "item_pay_amt": {
            "type": "string",
            "description": "Pay/handling amount, as a numeric string."
          },
          "item_pay_amt_range": {
            "type": "string",
            "description": "Pay amount range tier, as a numeric string."
          },
          "component_click_cnt": {
            "type": "string",
            "description": "Count as a numeric string."
          }
        },
        "additionalProperties": true
      },
      "description": "Present on the video branch (`detail_type` 1) only -- absent entirely on the products branch, which returns solely `base_resp`/`pagination`. Exactly one element was observed; the count on a larger page is unconfirmed."
    }
  },
  "description": "The conversion report, as returned at routing.responseResultPath ($.output). With `detail_type` requesting videos the populated branch carries a `video_list` array of per-video performance and engagement entries; the products branch (`detail_type` 2) was observed returning only `base_resp`/`pagination` for a creator with total_count 0 -- no `video_list` at all. No top-level field is required: a creator with no conversions in the requested detail type shapes to a near-empty object.",
  "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.004095
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 30, 2026