Qeasy Cloud
Get Started

领星ERP SB广告创意 API

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

SB广告创意

POST/pb/openapi/newad/hsaProductAds
Factory
{
  "operation": {
    "method": "POST",
    "path": "/pb/openapi/newad/hsaProductAds"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "data": [
      {
        "campaign_id": 800000000000137200,
        "ad_group_id": 800000000000137700,
        "ad_creative_id": 448868552891455,
        "creative_id": 26,
        "name": "demo sb ads 2023-02-27 7db7",
        "state": "ENABLED",
        "creation_date": 1704643200000,
        "last_updated_date": 1704643200000,
        "profile_id": 9000000000000013,
        "serving_status": "AD_STATUS_LIVE",
        "asin": [
          "B09MT9BKGH",
          "B0BB389BKQ",
          "B09MYZ614S"
        ],
        "creative_type": "PRODUCT_COLLECTION",
        "creative": {
          "type": "PRODUCT_COLLECTION",
          "asins": [
            "B085M6Q95G",
            "B085M76XY1",
            "B09HZM3HG3"
          ],
          "headline": "demo34demo34",
          "brandName": "demo34demo34",
          "brandLogoAssetID": "CQD921XpVdf9WBJSXliI",
          "customImageAssetId": null
        },
        "landing_page": {
          "url": null,
          "asins": [
            "B085M6Q95G",
            "B085M76XY1",
            "B09HZM3HG3"
          ],
          "pageType": "STORE"
        }
      }
    ],
    "total": 1,
    "next_token": "ODAwMDAwMDAwMDAwMDAyNDE3",
    "error_details": [],
    "request_id": "6bb694e1-3d25-4821-8db8-d55dc903f6ba",
    "response_time": "2024-05-22 15:52:53"
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1sid店铺idint9013Required店铺id
2profile_idVC广告店铺profile_idint123456RequiredVC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填
3offset分页偏移量int1Optional分页偏移量,默认0
4length分页长度int1Optional分页长度,默认15
5next_token分页游标string"MTAx"Optional分页游标,上次分页结果中的next_token (第一次分页无需填写,当next_token 和 offset同时存在时以next_token为主

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码int0Required状态码,0 成功
2message提示消息string操作成功Required提示消息
3error_details错误信息array—Required错误信息
4request_id请求链路idstring6bb694e1-3d25-4821-8db8-d55dc903f6baRequired请求链路id
5response_time响应时间string2023-02-17 09:59:19Required响应时间
6total总数int1Required总数
7next_token分页游标string"ODAwMDAwMDAwMDAwMDAyNDE3"Required分页游标,填入下次请求中的next_token
8data响应数据array—Required响应数据
8.1campaign_id广告活动idnumber800000000000137200Required广告活动id
8.2ad_group_id广告组idnumber800000000000137700Required广告组id
8.3ad_creative_id广告创意id(亚马逊)number448868552891455Required广告创意id(亚马逊)
8.4creative_id广告创意id(已作废)number26Required广告创意id(已作废)
8.5name广告创意名称stringdemo sb ads 2023-02-27 7db7Required广告创意名称
8.6state广告创意状态stringenabledRequired广告创意状态: ENABLED 启用 PAUSED 暂停 ARCHIVED 归档
8.7creation_date创建时间number1704643200000Required创建时间
8.8last_updated_date最后一次更新时间number1704643200000Required最后一次更新时间
8.9profile_id亚马逊店铺数字idnumber9000000000000013Required亚马逊店铺数字id
8.10serving_status服务状态stringAD_STATUS_LIVERequired服务状态: AD_POLICING_SUSPENDED INELIGIBLE REJECTED CAMPAIGN_OUT_OF_BUDGET CAMPAIGN_ARCHIVED ADVERTISER_PAYMENT_FAILURE CAMPAIGN_PAUSED AD_STATUS_LIVE PORTFOLIO_OUT_OF_BUDGET AD_GROUP_PAUSED PORTFOLIO_ENDED AD_PAUSED
8.11asin广告创意基础数据中ASIN字段array["B09MT9BKGH","B0BB389BKQ","B09MYZ614S"]Required广告创意基础数据中ASIN字段
8.12creative广告创意json详见返回成功示例Required广告创意
8.13creative_type广告创意类型stringPRODUCT_COLLECTIONRequired广告创意类型
8.14landing_page着落页json{"url": null, "asins": ["B085M6Q95G", "B085M76XY1", "B09HZM3HG3"], "pageType": "STORE"}Required着落页
8.15video_creatives当前广告关联的全部本地广告创意记录array—Required当前广告关联的全部本地广告创意记录,不按创意状态过滤;无关联创意时返回空数组
8.15.1creative_version广告创意版本stringcreative-9Required广告创意版本,不能作为视频素材版本使用
8.15.2creative_status广告创意状态stringDRAFTRequired广告创意状态
8.15.3creative_type广告创意类型stringVIDEORequired广告创意类型
8.15.4videos当前创意引用的视频素材列表array—Required当前创意引用的视频素材列表;无视频素材时返回空数组
8.15.4.1asset_id视频素材idstringasset-a:version_v1Required视频素材id,保留广告创意中的原始值,可能包含:version_xxx后缀
8.15.4.2versions视频素材在本地保存的全部版本array—Required视频素材在本地保存的全部版本,按本地记录id升序返回;未找到素材时返回空数组
8.15.4.2.1asset_version视频素材版本string2Required视频素材版本,按数据库字符串原值返回
8.15.4.2.2name本地视频素材名称string商品演示视频Required本地视频素材名称
8.15.4.2.3url本地视频素材地址stringhttps://example.com/video-2.mp4Required本地视频素材地址,对应storage_location_urls.defaultUrl;地址缺失或格式异常时返回null

The SB广告创意 API (/pb/openapi/newad/hsaProductAds) 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.