Federal Executive Agency Internet Domains as of 02/07/2013

List of Federal Executive Agency Internet domains.

Getting Started

All communication with the API is done through HTTPS, and errors are communicated through HTTP response codes. Available response types include JSON, XML, and CSV, which are selectable by the "extension" on API requests or by HTTP Accepts headers.

This documentation also includes inline, runable examples. Click on any link that contains a gear symbol next to it to run that example live against the Federal Executive Agency Internet Domains as of 02/07/2013 API.

App Tokens

All requests should include an app token that identifies your application, and each application should have its own unique app token. A limited number of requests can be made without an app token, but they are subject to much lower throttling limits than request that do include one. If you don't have an app token yet, click the button to the right to sign up for one.

Once you have an app token, you can include it with your request either by using the X-App-Token HTTP header, or by passing it via the $app_token parameter on your URL.

Response Codes

One of the following response codes will be returned with every request:

  1. 200Successful request.
  2. 202Request processing. You can retry your request, and when it's complete, you'll get a 200 instead.
  3. 400Bad request
  4. 401Unauthorized. You're not authorized to access this resource.
  5. 404Not found. The resource requested doesn't exist.
  6. 429Too Many Requests. The client has made too many requests and is currently being rate limited.
  7. 500Server errors. Our bad!

Code Samples

#!/usr/bin/env ruby

require 'net/https'
uri = URI('https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?recall_id=94')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER

request = Net::HTTP::Get.new(uri.request_uri)
request.add_field('X-App-Token', ARGV[0])

response = http.request(request)
puts response.code
puts response.body
#!/usr/bin/env python

import sys
import requests

r = requests.get('https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?recall_id=94', headers={'X-App-Token': sys.argv[1]})
print r.status_code
print r.text
request = require 'request'
options = uri: 'https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?$$app_token=APP_TOKEN&recall_id=94'
request options, (err, response, body) ->  console.log body
#!/bin/sh 

curl --header "X-App-Token: $1" "https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?recall_id=94"

Fields

The following fields are available on the Federal Executive Agency Internet Domains as of 02/07/2013 API.

domain_name

Human Name: Domain Name
Type: text

Examples

Retrieve all records with domain_name equal to YOUTHRULES.GOV:

Retrieve all records where domain_name is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?$where=within_circle(domain_name, 47.598177,-122.33448, 1000)

domain_name_address

Human Name: Domain Name Address
Type: text

Examples

Retrieve all records with domain_name_address equal to https://www.E-QIP.GOV:

Retrieve all records where domain_name_address is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?$where=within_circle(domain_name_address, 47.598177,-122.33448, 1000)

federal_agency

Human Name: Federal Agency
Type: text

Examples

Retrieve all records with federal_agency equal to US Interagency Council on Homelessness:
Retrieve all records with federal_agency equal to US Interagency Council on Homelessness:

Retrieve all records where federal_agency is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?$where=within_circle(federal_agency, 47.598177,-122.33448, 1000)

redirecting

Human Name: Redirecting
Type: number

Examples

Retrieve all records with redirecting equal to 303:

Retrieve all records where redirecting is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?$where=within_circle(redirecting, 47.598177,-122.33448, 1000)

redirect_destination

Human Name: Redirect Destination
Type: text

Examples

Retrieve all records with redirect_destination equal to www2.niddk.nih.gov:

Retrieve all records where redirect_destination is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/federal-executive-agency-internet-domains.json?$where=within_circle(redirect_destination, 47.598177,-122.33448, 1000)