Lingxing
切换旧版

SP广告添加否定关键词

POST/basicOpen/adReport/spTarget/addNegativeKeywords

支持广告活动层级和广告组层级,一次最多1000个否定关键词

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/spTarget/addNegativeKeywordsHTTPSPOST1

请求参数

profileIdinteger
店铺 Profile ID,profileId和sid不能同时为空
sidinteger
店铺id,profileId和sid不能同时为空
negativeKeywordsarray<object>必填
否定关键词列表(最多1000个)
隐藏子属性
campaignIdstring必填
SP广告活动ID
对应【基础数据-SP广告活动】接口中的campaign_id
adGroupIdstring
广告组ID(可选,不传则为广告活动层级)
对应【基础数据-SP广告组】接口中的ad_group_id
keywordstring必填
否定关键词文本
matchTypestring必填
否定匹配类型
negativeExact: 精确匹配
negativePhrase: 词组匹配
statestring必填
否定关键词状态
ENABLED: 启用
PAUSED: 暂停

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/spTarget/addNegativeKeywords?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sid": 134225003201380864,
    "negativeKeywords": [
        {
            "campaignId": "12345",
            "adGroupId": "67890",
            "keyword": "example keyword",
            "matchType": "negativeExact",
            "state": "ENABLED"
        }
    ]
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-04-20 12:00:00
dataobject必填
响应数据
隐藏子属性
successarray<object>必填
创建成功的列表
隐藏子属性
indexinteger必填
请求中的索引位置
示例 0
targetobject必填
创建成功的Target信息
隐藏子属性
targetIdstring必填
Target唯一标识
示例 12345
campaignIdstring必填
广告活动ID
示例 12345
adGroupIdstring必填
广告组ID
示例 67890
statestring必填
状态
示例 ENABLED
targetTypestring必填
投放类型
示例 KEYWORD
errorarray<object>必填
创建失败的列表
隐藏子属性
indexinteger必填
请求中的索引位置
示例 1
errorsarray<object>必填
错误信息列表
隐藏子属性
codestring必填
错误码
示例 INVALID_ARGUMENT
messagestring必填
错误消息
示例 Invalid keyword

返回成功示例

{
    "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": []
    }
}