Returns localized keywords.

POST

/keywords/localize

最后修改时间：2026-08-27 23:21:02

责任人：未设置

返回指定 marketplace 或 locale 内的本地化关键词。

授权资源类型：
全球广告账户 ID、配置文件 ID

参数名称：
Amazon-Ads-AccountId

参数位置：
标头

需要以下权限之一：
["advertiser_campaign_edit","advertiser_campaign_view"]

请求参数

Header 参数

Body 参数

application/vnd.keywordlocalization.v1+json

必填

示例

{
    "localizeKeywordRequests": [
        {
            "localizationKeyword": {
                "property1": {
                    "keyword": "string"
                },
                "property2": {
                    "keyword": "string"
                }
            }
        }
    ],
    "sourceDetails": {
        "countryCode": "string",
        "locale": "string",
        "marketplaceId": "string"
    },
    "targetDetails": {
        "countryCodes": [
            "string"
        ],
        "locales": [
            "string"
        ],
        "marketplaceIds": [
            "string"
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/keywords/localize' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Amazon-Advertising-API-Scope;' \
--header 'Amazon-Ads-AccountId;' \
--header 'Content-Type: application/vnd.keywordlocalization.v1+json' \
--data '{
    "localizeKeywordRequests": [
        {
            "localizationKeyword": {
                "property1": {
                    "keyword": "string"
                },
                "property2": {
                    "keyword": "string"
                }
            }
        }
    ],
    "sourceDetails": {
        "countryCode": "string",
        "locale": "string",
        "marketplaceId": "string"
    },
    "targetDetails": {
        "countryCodes": [
            "string"
        ],
        "locales": [
            "string"
        ],
        "marketplaceIds": [
            "string"
        ]
    }
}'

返回响应

🟢200成功

application/vnd.keywordlocalization.v1+json

成功。

Bodyapplication/vnd.keywordlocalization.v1+json

示例

{}

🟠400请求有误

🟠401没有权限

🟠429

🔴500服务器错误

修改于 2026-08-27 23:21:02

Gets an array of localized currencies in their target marketplaces using advertiser identifier in header, and source marketplace ID (via marketplaceId or countryCode) in the body

Returns localized products.