News from our Blog
If you are using the Social Media Registry API and have feedback or want to tell us about your product, please e-mail us.
This documentation describes methods to use the Social Media Registry API to access the contents of the Social Media Registry.
The Social Media Registry is an official source of information about social media accounts that represent official U.S. federal government agencies, elected officials, or members of the President’s Cabinet.
If you work for the federal government and have a .gov or .mil e-mail address, you can register official U.S. federal accounts at HowTo.gov.
If you have questions about the Social Media Registry, please e-mail firstname.lastname@example.org.
The interface described here uses the same method URLs and parameters for all response formats, including HTML5, JSON, and XML. If no response format is specified at request time, the results are returned as HTML5 (with the assumption that a user is accessing the API via a web browser). To specify alternate formats, append the result format to the method call:
If support for older browsers is required, JSON requests can be made with a callback parameter in order to return JSONP responses:
Some API methods are also available as feeds in the ATOM format. These feeds can be added to any news feed reader to list recent changes.
The ATOM format is an XML feed standard; each entry contains a summary of the Registry change and a link to the Registry API to view more information.
List the most recently updated official Twitter accounts: http://registry.usa.gov/accounts.atom?service_id=twitter
List the most recently updated official accounts from the U.S. Department of Agriculture: http://registry.usa.gov/accounts.atom?agency_id=usda
List official U.S. government social media accounts entries in the registry. This method is also available as an ATOM feed.
List all official accounts from the U.S. Department of Agriculture: http://registry.usa.gov/accounts?agency_id=usda
List all official Twitter accounts from the U.S. Department of Health and Human Services:
A synonym for the /accounts/verify method, using a canonical service and account ID provided by that method. For example, the service and account ID for http://twitter.com/JPL_Bear might be twitter/JPL_Bear, making the canonical URL take the form http://registry.usa.gov/accounts/twitter/JPL_Bear
This is provided primarily for REST-style browsing.
Check whether the provided URL is registered as an official government social media account.
(if verified is true:)
List the sponsoring agencies that may be specified in the /accounts/add method.
List the social media services that are currently supported in the /accounts/add method.
List tags that are suggested for describing an account.
The code for the Social Media Registry is open source and available on GitHub. It is written in Ruby.
By accessing the Social Media Registry API, you agree to our Terms of Service.
Page Last Reviewed or Updated: February 14, 2013