Qeasy Cloud
Get Started

领星ERP SP投放小时数据 API

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

SP投放小时数据

POST/pb/openapi/newad/spTargetHourData
Factory
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/spTargetHourData"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "data": [
      {
        "profile_id": 2537307927915183,
        "report_date": "2024-05-25",
        "hour": 23,
        "campaign_id": 532580134831120,
        "ad_id": 347244425807704,
        "asin": "B085M7XMJF",
        "match_type": "EXACT",
        "impressions": 34,
        "clicks": 7,
        "cost": 3.52,
        "same_orders": 2,
        "orders": 1,
        "same_sales": 28.89,
        "sales": 54.03,
        "same_units": 3,
        "units": 11,
        "ctr": 0.2059,
        "cpc": 0.5,
        "cvr": 0.1429,
        "cpa": 3.52,
        "acos": 0.0651,
        "roas": 15.35,
        "group_id": 287918863539910,
        "msku": null,
        "targeting_id": 339153487021379,
        "targeting": "spotting scope with rangefinder"
      }
    ],
    "total": 1167,
    "next_token": null,
    "error_details": [],
    "request_id": "f884f0a6-f1e9-49d1-b144-a85ee4b57ed9",
    "response_time": "2024-05-28 17:38:00"
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1report_date报告日期string—Required报告日期,格式:Y-m-d 只能查询最近61天(最早为当天往前第61天,最晚为当天,含两端)
2campaign_id广告活动idnumber—Optional广告活动id,必须为正整数;与campaign_ids至少传入一个,两者会合并去重
3campaign_ids广告活动id列表array<any>—Optional广告活动id列表,与campaign_id合并去重后最多50个,元素必须为正整数
4agg_dimension聚合维度(区分大小写)string—Required聚合维度(区分大小写): target 投放维度 both_ad_target 广告+投放维度 both_target_placement 投放+广告位placement维度 all_ad_target_placement 广告+投放+广告位placement维度

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码number0Required状态码,0 成功
2message提示消息string操作成功Required提示消息
3total总数(等于data数组的条数)number1167Required总数(等于data数组的条数)
4next_token游标分页tokenstring—Required游标分页token,本接口无分页,恒为null
5error_details错误信息array<any>—Required错误信息
6request_id请求链路idstringf884f0a6-f1e9-49d1-b144-a85ee4b57ed9Required请求链路id
7response_time响应时间string2024-05-28 17:38:00Required响应时间
8data响应数据array<object>—Required响应数据
8.1profile_id店铺idnumber2537307927915183Required店铺id
8.2report_date报告日期string2024-05-25Required报告日期
8.3hour小时number23Required小时: 0 表示0-1点之间 1 表示 1-2点之间 以此类推
8.4campaign_id广告活动idnumber532580134831120Required广告活动id
8.5ad_idad_idnumber347244425807704Required广告id【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回】
8.6asinasinstringB085M7XMJFRequired广告对应asin【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回;匹配不到广告信息时为null】
8.7mskumskustring—Required广告对应msku【agg_dimension 为 both_ad_target 或 all_ad_target_placement 时返回;匹配不到广告信息时为null】
8.8match_typematch_typestringEXACTRequired匹配方式【本接口所有合法聚合维度(target/both_ad_target/both_target_placement/all_ad_target_placement)均返回;数据仅存在于转化表时可能为null】
8.9targeting_idtargeting_idnumber339153487021379Required投放id【本接口所有合法聚合维度(target/both_ad_target/both_target_placement/all_ad_target_placement)均返回】
8.10targetingtargetingstringspotting scope with rangefinderRequired投放表达式【本接口所有合法聚合维度(target/both_ad_target/both_target_placement/all_ad_target_placement)均返回;数据仅存在于转化表时可能为null】
8.11placementplacementstring—Required广告位【agg_dimension 为 both_target_placement 或 all_ad_target_placement 时返回】
8.12impressions曝光量(无流量数据时为0)number34Required曝光量(无流量数据时为0)
8.13clicks点击量(无流量数据时为0)number7Required点击量(无流量数据时为0)
8.14cost花费(无流量数据时为0)number3.52Required花费(无流量数据时为0)
8.15same_orders直接成交订单(无转化数据时为0)number2Required直接成交订单(无转化数据时为0)
8.16orders订单数(无转化数据时为0)number1Required订单数(无转化数据时为0)
8.17same_sales直接销售额(无转化数据时为0)number28.89Required直接销售额(无转化数据时为0)
8.18sales销售额(无转化数据时为0)number54.03Required销售额(无转化数据时为0)
8.19same_units直接成交销量(无转化数据时为0)number3Required直接成交销量(无转化数据时为0)
8.20units销量(无转化数据时为0)number11Required销量(无转化数据时为0)
8.21ctr点击/曝光【保留4位小数number0.2059Required点击/曝光【保留4位小数;曝光量为0时为null】
8.22cpc花费/点击【保留2位小数number0.5Required花费/点击【保留2位小数;点击量为0时为null】
8.23cvr订单数/点击【保留4位小数number0.1429Required订单数/点击【保留4位小数;点击量为0时为null】
8.24cpa花费/订单数【保留2位小数number3.52Required花费/订单数【保留2位小数;订单数为0时为null】
8.25acos花费/销售额【保留4位小数number0.0651Required花费/销售额【保留4位小数;销售额为0时为null】
8.26roas销售额/花费【保留2位小数number15.35Required销售额/花费【保留2位小数;花费为0时为null】
8.27group_id广告组idnumber287918863539910Required广告组id

The SP投放小时数据 API (/pb/openapi/newad/spTargetHourData) 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.