Setting "Broad Match Keywords" On/Off for Search Campaign via API

[Amit Tomar]

Dear Team,

I am working on creating a Search campaign (with the "Website traffic" objective) using the Google Ads API.

In the Google Ads UI, during campaign setup, there is a setting under Campaign Settings labeled "Broad match keywords", where you can select either:

• "On: Use broad match keywords for your entire campaign", or

• "Off: Use keyword match types".

For reference, I have attached a screenshot showing this section.

Could you please clarify:

1. Which field or setting should be used in the API to define this "Broad match keywords" option while creating a campaign?

2. What values should be set to enable or disable this option via the API?

Thank you for your guidance and support.

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

• To enable the 'Broad match keywords', set the 'keywordMatchType':BROAD in the campaign:mutate while creating the campaign as below: 

POST https://googleads.googleapis.com/v19/customers/{customer Id}/campaigns:mutate?key=[YOUR_API_KEY] HTTP/1.1

developer-token: **********************
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Accept: application/json
Content-Type: application/json

{
  "operations": [
    {
      "create": {
        "campaignBudget": "customers/{customer Id}/campaignBudgets/{campaign Budget Id}",
        "biddingStrategy": "customers/{customer Id}/biddingStrategies/{bidding strategy Id}",
        "advertisingChannelType": "SEARCH",
        "name": "test_forBoradMatch1",
        "keywordMatchType": "BROAD"
      }
    }
  ]
}

{
  "results": [
    {
      "resourceName": "customers/{customer Id}/campaigns/{campaign Id}"
    }
  ]
}

• To disable the 'Broad match keywords', set the 'keywordMatchType':UNSPECIFIED in the campaign:mutate while creating a campaign or you can update for an existing campaign as below:

curl --request POST \

 'https://googleads.googleapis.com/v19/customers/{customer Id}/campaigns:mutate?key=[YOUR_API_KEY]' \

 --header 'developer-token: **********************' \

 --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \

 --header 'Accept: application/json' \

 --header 'Content-Type: application/json' \

 --data '{"operations":[{"update":{"resourceName":"customers/{customer Id}/campaigns/{campaign id}","keywordMatchType":"UNSPECIFIED"},"updateMask":"resourceName,keywordMatchType"}]}' \

 --compressed

 

{

 "results": [

  {

   "resourceName": "customers/{customer Id}/campaigns/{campaign id}"

  }

 ]

}

 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-04-28 11:25:27Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01qV8Sz:ref" (ADR-00302514)

[Amit Tomar]

Thank you!