Qeasy Cloud
Get Started

领星ERP SP广告添加否定关键词 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
广告 / 广告管理 · POST · 请求参数 8 个(必填 5) · 响应参数 19 个 · 限流令牌桶容量 1
Updated At
2026-11-21

SP广告添加否定关键词

POST/basicOpen/adReport/spTarget/addNegativeKeywords
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/spTarget/addNegativeKeywords"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/spTarget/addNegativeKeywords?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"sid\": 134225003201380864,\n    \"negativeKeywords\": [\n        {\n            \"campaignId\": \"12345\",\n            \"adGroupId\": \"67890\",\n            \"keyword\": \"example keyword\",\n            \"matchType\": \"negativeExact\",\n            \"state\": \"ENABLED\"\n        }\n    ]\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-04-20 12:00:00",
    "data": {
      "success": [
        {
          "index": 0,
          "target": {
            "targetId": "12345",
            "campaignId": "67890",
            "adGroupId": "11111",
            "state": "ENABLED",
            "targetType": "KEYWORD",
            "targetLevel": "AD_GROUP"
          }
        }
      ],
      "error": []
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1profileId店铺 Profile IDinteger—Optional店铺 Profile ID,profileId和sid不能同时为空
2sid店铺idinteger—Optional店铺id,profileId和sid不能同时为空
3negativeKeywords否定关键词列表(最多1000个)array<object>—Required否定关键词列表(最多1000个)
3.1campaignIdSP广告活动IDstring—RequiredSP广告活动ID 对应【基础数据-SP广告活动】接口中的campaign_id
3.2adGroupId广告组ID(可选string—Optional广告组ID(可选,不传则为广告活动层级) 对应【基础数据-SP广告组】接口中的ad_group_id
3.3keyword否定关键词文本string—Required否定关键词文本
3.4matchType否定匹配类型string—Required否定匹配类型 negativeExact: 精确匹配 negativePhrase: 词组匹配
3.5state否定关键词状态string—Required否定关键词状态 ENABLED: 启用 PAUSED: 暂停

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-04-20 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1success创建成功的列表array<object>—Required创建成功的列表
6.1.1index请求中的索引位置integer0Required请求中的索引位置
6.1.2target创建成功的Target信息object—Required创建成功的Target信息
6.1.2.1targetIdTarget唯一标识string12345RequiredTarget唯一标识
6.1.2.2campaignId广告活动IDstring12345Required广告活动ID
6.1.2.3adGroupId广告组IDstring67890Required广告组ID
6.1.2.4state状态stringENABLEDRequired状态
6.1.2.5targetType投放类型stringKEYWORDRequired投放类型
6.2error创建失败的列表array<object>—Required创建失败的列表
6.2.1index请求中的索引位置integer1Required请求中的索引位置
6.2.2errors错误信息列表array<object>—Required错误信息列表
6.2.2.1code错误码stringINVALID_ARGUMENTRequired错误码
6.2.2.2message错误消息stringInvalid keywordRequired错误消息

The SP广告添加否定关键词 API (/basicOpen/adReport/spTarget/addNegativeKeywords) 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.