Announcement: Increased batch size for targeting criteria

announcements
targeting

#1

Our POST batch/accounts/:account_id/targeting_criteria endpoint allows targeting criteria for multiple line items to be created or deleted with a single request.

Until now, the maximum number of operations in a batch was 100. Today, we are announcing that we have increased this to 1,000.

Twitter Ads API Team


Request details:

  • the Content-Type: application/json header is required
  • parameters are sent in the request body
  • batch requests fail or succeed as a group

Response details:

  • responses for both errors and successes are preserved in the order of the initial request

Usage example:

$ twurl -H ads-api.twitter.com -X POST -A "Content-Type: application/json" -d '[{"operation_type":"Create","params":{"line_item_id":"6f9an","targeting_type":"LOCATION","targeting_value":"5122804691e5fecc"}},{"operation_type":"Delete","params":{"targeting_criterion_id":"al2rua"}}]' "/1/batch/accounts/18ce54d4x5t/targeting_criteria" | jq 
{
  "data_type": "targeting_criterion",
  "data": [
    {
      "line_item_id": "6f9an",
      "name": "San Francisco-Oakland-San Jose CA, US",
      "id": "al7vt2",
      "location_type": "CITY",
      "operator_type": "EQ",
      "created_at": "2016-11-11T22:59:50Z",
      "targeting_value": "5122804691e5fecc",
      "updated_at": "2016-11-11T22:59:50Z",
      "deleted": false,
      "targeting_type": "LOCATION"
    },
    {
      "line_item_id": "6keuo",
      "name": "accounts",
      "id": "al2rua",
      "operator_type": "EQ",
      "created_at": "2016-11-11T17:50:19Z",
      "targeting_value": "accounts",
      "updated_at": "2016-11-11T22:59:50Z",
      "deleted": true,
      "targeting_type": "BROAD_KEYWORD"
    }
  ],
  "request": [
    {
      "params": {
        "line_item_id": "6f9an",
        "targeting_type": "LOCATION",
        "targeting_value": "5122804691e5fecc",
        "account_id": "18ce54d4x5t"
      },
      "operation_type": "Create"
    },
    {
      "params": {
        "targeting_criterion_id": "al2rua",
        "account_id": "18ce54d4x5t"
      },
      "operation_type": "Delete"
    }
  ]
}

For readability, the parameter array is shown below.

[
    {
        "operation_type":"Create",
        "params":{
            "line_item_id":"6f9an",
            "targeting_type":"LOCATION",
            "targeting_value":"5122804691e5fecc"
        }
    },
    {
        "operation_type":"Delete",
        "params":{
            "targeting_criterion_id":"al2rua"
        }
    }
]

#2

#3