轻易云
注册体验

领星ERP查询TikTok - GMV MAX - 广告商品接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 / 广告 / TikTok广告 · POST · 请求参数 14 个(必填 0) · 响应参数 32 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询TikTok - GMV MAX - 广告商品

POST/basicOpen/multiplatform/ads/queryGmvItemGroupReportList
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/queryGmvItemGroupReportList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryGmvItemGroupReportList?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"endDate\": \"2024-11-17\",\n    \"length\": 20,\n    \"page\": 1,\n    \"startDate\": \"2024-11-01\",\n    \"advertiserIds\": [123456789012345],\n    \"bidTypeCodes\": [\"CUSTOM\",\"NO_BID\"],\n    \"campaignIds\": [123456789012345],\n    \"itemGroupIds\": [123456789012345],\n    \"orderField\": \"grossRevenue\",\n    \"orderType\": \"DESC\",\n    \"ownerBcIds\": [123456789012345],\n    \"status\": [\"available\",\"unavailable\"],\n    \"storeIds\": [123456789012345],\n    \"summaryCurrency\": \"USD\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
    "response_time": "2024-11-12 16:00:00",
    "data": {
      "list": [
        {
          "bidTypeCode": "CUSTOM",
          "bidTypeName": "目标ROI",
          "currencyCode": "USD",
          "currencyRateMissingCount": "0",
          "enabledCampaignId": "123456789012345",
          "enabledCampaignName": "双十一推广系列",
          "endDate": "2024-11-01",
          "grossRevenue": "251.25",
          "itemGroupId": "123456789012345",
          "orders": "10",
          "productImageUrl": "https://example.com/product.jpg",
          "productStatusCode": "available",
          "productStatusName": "可用",
          "startDate": "2024-11-01",
          "storeCode": "STORE001",
          "storeId": "123456789012345",
          "storeName": "旗舰店",
          "subjectId": "REPORT_123456",
          "title": "iPhone 15 Pro Max",
          "reportDate": "2024-11-01",
          "cost": 100.5,
          "costPerOrder": 10.05,
          "roi": 2.5
        }
      ],
      "total": 100
    },
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1endDate结束日期string—可选结束日期,必填,格式:yyyy-MM-dd,与开始日期间隔不超过31天
2length每页条数integer—可选每页条数,必填,小于2000
3page页码integer—可选页码,必填
4startDate开始日期string—可选开始日期,必填,格式:yyyy-MM-dd
5advertiserIds广告账号ID列表array<any>—可选广告账号ID列表,Long数组
6bidTypeCodes优化模式编码列表array<any>—可选优化模式编码列表,String数组,枚举值:CUSTOM-目标ROI, NO_BID-最大投放量
7campaignIds推广系列ID列表array<any>—可选推广系列ID列表,Long数组
8itemGroupIds广告商品ID列表array<any>—可选广告商品ID列表,Long数组
9orderField排序字段string—可选排序字段
10orderType排序方式string—可选排序方式,枚举值:ASC-升序, DESC-降序
11ownerBcIds广告主账号ID列表array<any>—可选广告主账号ID列表,Long数组
12status商品状态编码列表array<any>—可选商品状态编码列表,String数组,枚举值:available-可用, unavailable-不可用
13storeIds店铺ID列表array<any>—可选店铺ID列表,Long数组
14summaryCurrency汇总币种编码string—可选汇总币种编码

接口响应参数

序号字段名称类型默认值必填描述
1code响应码integer—必填响应码
2data返回数据object—必填返回数据
2.1list报告列表array<object>—必填报告列表,Report对象数组
2.1.1bidTypeCode优化模式编码stringCUSTOM必填优化模式编码,枚举值:CUSTOM-目标ROI, NO_BID-最大投放量
2.1.2bidTypeName优化模式名称string目标ROI必填优化模式名称
2.1.3currencyCode币种编码stringUSD必填币种编码
2.1.4currencyRateMissingCount币种汇率缺失计数string0必填币种汇率缺失计数
2.1.5enabledCampaignId启用的推广系列IDstring123456789012345必填启用的推广系列ID
2.1.6enabledCampaignName启用的推广系列名称string双十一推广系列必填启用的推广系列名称
2.1.7endDate结束日期string2024-11-17必填结束日期,格式:yyyy-MM-dd
2.1.8grossRevenue总收入string12345.67必填总收入
2.1.9itemGroupId商品SPU IDstring123456789012345必填商品SPU ID
2.1.10orders订单数string150必填订单数
2.1.11productImageUrl商品图片URLstringhttps://example.com/product.jpg必填商品图片URL
2.1.12productStatusCode商品状态编码stringavailable必填商品状态编码,枚举值:available-可用, unavailable-不可用
2.1.13productStatusName商品状态名称string可用必填商品状态名称
2.1.14startDate开始日期string2024-11-01必填开始日期,格式:yyyy-MM-dd
2.1.15storeCode店铺编码stringSTORE001必填店铺编码
2.1.16storeId店铺IDstring123456789012345必填店铺ID
2.1.17storeName店铺名称string旗舰店必填店铺名称
2.1.18subjectId报告主体IDstringREPORT_123456必填报告主体ID
2.1.19title商品标题stringiPhone 15 Pro Max必填商品标题
2.1.20reportDate当startDate与endDate一致时返回string2024-11-30可选当startDate与endDate一致时返回
2.1.21cost成本number100.5必填成本
2.1.22costPerOrder平均下单成本number10.05必填平均下单成本
2.1.23roiroinumber2.5必填ROI
2.2total总记录数string1000必填总记录数
3error_details错误详情array<any>—必填错误详情
4message提示信息string—必填提示信息
5request_id请求idstring—必填请求id
6response_time响应时间string—必填响应时间
7total总记录数integer—必填总记录数

领星ERP的接口:查询TikTok - GMV MAX - 广告商品(/basicOpen/multiplatform/ads/queryGmvItemGroupReportList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。