Qeasy Cloud
Get Started

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

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 / 广告 / TikTok广告 · POST · 请求参数 14 个(必填 0) · 响应参数 32 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询TikTok - GMV MAX - 广告商品

POST/basicOpen/multiplatform/ads/queryGmvItemGroupReportList
Factory
{
  "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
  }
}

Request Parameters

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

Response Parameters

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

The 查询TikTok - GMV MAX - 广告商品 API (/basicOpen/multiplatform/ads/queryGmvItemGroupReportList) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.