newsdev/nyt-prb-scraper

Name: nyt-prb-scraper

Owner: NYT Newsroom Developers

Description: A scraper and parser for the Periodic Review Secretariat's web pages for Guantanamo detainees.

Created: 2016-09-16 01:33:09.0

Updated: 2017-02-14 15:36:08.0

Pushed: 2017-01-20 14:59:48.0

Homepage: null

Size: 16

Language: Python

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

NYT PRB Scraper

From their website: “The Periodic Review Secretariat (PRS) develops and administers the periodic review process for eligible Guantanamo Bay detainees, including provision of personal representatives to detainees.”

Usage

The PRB engages in three different forms of review for a Guantanamo detainee"s documents: An initial review, a file review and a full review. Technically, a fourth type, the subsequent full review, is available. To date, no subsequent full reviews have been posted.

Initial review

ial_review --csv > initial_review.csv
ial_review --json > initial_review.json
ial_review --tsv > initial_review.tsv

File review

_review --csv > file_review.csv
_review --json > file_review.json
_review --tsv > file_review.tsv

Full review

_review --csv > full_review.csv
_review --json > full_review.json
_review --tsv > full_review.tsv

Schema

Returns a row or an object for every document. Each document contains the document-specific fields like type_name, type_id, and url as well as the detainee-specific fields like name and isn. Builds a unique id for each document from isn-type_id-hearing_or_review_date.

{
    "review_type": "full-review",
    "review_url": "http://www.prs.mil/Review-Information/Initial-Review/",
    "hearing_or_review_date":"2014-11-05",
    "denial":null,
    "name":"Abdel Malik Ahmed Abdel Wahab Al Rahabi",
    "type_id":"1",
    "url":"http:\/\/www.prs.mil\/Portals\/60\/Documents\/ISN037\/141105_U_ISN037_GOVERNMENT'S_UNCLASSIFIED_SUMMARY_PUBLIC.pdf",
    "type_name":"Government's Unclassified Summary",
    "id":"037-initial-review-1-2014-11-05",
    "isn":"037",
    "denied":false,
    "notification_date":"2014-08-26",
    "final_determination_date":"2014-12-05"
},
{
    "review_type": "full-review",
    "review_url": "http://www.prs.mil/Review-Information/Initial-Review/",
    "hearing_or_review_date":"2014-11-05",
    "denial":null,
    "name":"Abdel Malik Ahmed Abdel Wahab Al Rahabi",
    "type_id":"2",
    "url":"http:\/\/www.prs.mil\/Portals\/60\/Documents\/ISN037\/141105_U_ISN037_PR_STATEMENT_PRB.pdf",
    "type_name":"Opening Statements of Detainee's Representatives",
    "id":"037-initial-review-2-2014-11-05",
    "isn":"037",
    "denied":false,
    "notification_date":"2014-08-26",
    "final_determination_date":"2014-12-05"
},
{
    "review_type": "full-review",
    "review_url": "http://www.prs.mil/Review-Information/Initial-Review/",
    "hearing_or_review_date":"2014-11-05",
    "denial":null,
    "name":"Abdel Malik Ahmed Abdel Wahab Al Rahabi",
    "type_id":"3",
    "url":"http:\/\/www.prs.mil\/Portals\/60\/Documents\/ISN037\/141216_U_ISN037_DETAINEE_WRITTEN_SUBMISSION_PUBLIC.pdf",
    "type_name":"Detainee's Written Submission",
    "id":"037-initial-review-3-2014-11-05",
    "isn":"037",
    "denied":false,
    "notification_date":"2014-08-26",
    "final_determination_date":"2014-12-05"
},
{
    "review_type": "full-review",
    "review_url": "http://www.prs.mil/Review-Information/Initial-Review/",
    "hearing_or_review_date":"2014-11-05",
    "denial":null,
    "name":"Abdel Malik Ahmed Abdel Wahab Al Rahabi",
    "type_id":"4",
    "url":"http:\/\/www.prs.mil\/LinkClick.aspx?fileticket=RFOMdQD69k4%3d&tabid=8447&portalid=60&mid=20067",
    "type_name":"Transcript of Public Session",
    "id":"037-initial-review-4-2014-11-05",
    "isn":"037",
    "denied":false,
    "notification_date":"2014-08-26",
    "final_determination_date":"2014-12-05"
},
{
    "review_type": "full-review",
    "review_url": "http://www.prs.mil/Review-Information/Initial-Review/",
    "hearing_or_review_date":"2014-11-05",
    "denial":null,
    "name":"Abdel Malik Ahmed Abdel Wahab Al Rahabi",
    "type_id":"5",
    "url":"http:\/\/www.prs.mil\/Portals\/60\/Documents\/ISN037\/141105_U_ISN037_TRANSCRIPT_OF_DETAINEE_SESSION_PUBLIC.pdf",
    "type_name":"Transcript of Detainee Session",
    "id":"037-initial-review-5-2014-11-05",
    "isn":"037",
    "denied":false,
    "notification_date":"2014-08-26",
    "final_determination_date":"2014-12-05"
},
{
    "review_type": "full-review",
    "review_url": "http://www.prs.mil/Review-Information/Initial-Review/",
    "hearing_or_review_date":"2014-11-05",
    "denial":null,
    "name":"Abdel Malik Ahmed Abdel Wahab Al Rahabi",
    "type_id":"6",
    "url":"http:\/\/www.prs.mil\/LinkClick.aspx?fileticket=s0XT-7qYc94%3d&tabid=8447&portalid=60&mid=20067",
    "type_name":"Unclassified Summary of Final Determination",
    "id":"037-initial-review-6-2014-11-05",
    "isn":"037",
    "denied":false,
    "notification_date":"2014-08-26",
    "final_determination_date":"2014-12-05"
}

Output

The scrapers can return CSV, JSON or TSV. The default if no options are passed is CSV.