More changes to withheld content fields

Friday, 2 November 2012

Last week we announced upcoming changes to withheld content fields which unified the “withheld_in_countries” field across our APIs to a standard format: an array of uppercase country codes.

We have deployed this change today. With this deploy, we will also introduce two custom country codes which will represent the following scenarios:

  1. When a Tweet is withheld in all countries, we will use the country code XX instead of enumerating every country. For example:
    "withheld_in_countries": ["XX"]
    
  2. When a Tweet is withheld due to a DMCA complaint, we will use the country code XY and also introduce a boolean withheld_copyright attribute set to true. For example:
    "withheld_copyright": true,
    "withheld_in_countries": ["XY"]
    

As of today, no Tweets have fallen into either category—of being withheld in all countries or withheld due to a DMCA complaint, so there are no existing representations which will change due to this addition.

Please continue to use this discussion thread to ask questions or leave feedback about this change.