full_text_search/full_text_search.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Full Text Search\n",
    "This notebook shows how to use the API's search functionality"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "import requests\n",
    "from collections import OrderedDict\n",
    "\n",
    "keyword = \"turkey\"\n",
    "\n",
    "starting_url = 'https://api.case.law/v1/cases/?search=' + keyword\n",
    "\n",
    "jurisdictions = {}\n",
    "results_count = 0"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Results for keyword: turkey\n",
      "Total cases: 18948\n"
     ]
    }
   ],
   "source": [
    "def get_pages(url):\n",
    "    while True:\n",
    "        result = requests.get(url).json()\n",
    "        yield result\n",
    "        url = result['next']\n",
    "        if not url:\n",
    "            break\n",
    "\n",
    "def get_results(url):\n",
    "    for page in get_pages(url):\n",
    "        for result in page['results']:\n",
    "            yield result\n",
    "\n",
    "for case in get_results(starting_url):\n",
    "    results_count += 1\n",
    "\n",
    "    id = case['id']\n",
    "    name = case['name_abbreviation']\n",
    "    jurisdiction = case['jurisdiction']['name']\n",
    "    date = case['decision_date']\n",
    "    url = case['url']\n",
    "\n",
    "    if jurisdiction not in jurisdictions:\n",
    "        jurisdictions[jurisdiction] = {'name': jurisdiction, 'count': 1, 'oldest_case_id': id,\n",
    "                                       'oldest_case_name': name, 'oldest_case_date': date, 'oldest_case_url': url}\n",
    "\n",
    "    else:\n",
    "        new_count = jurisdictions[jurisdiction]['count'] + 1\n",
    "        if jurisdictions[jurisdiction]['oldest_case_date'] > date:\n",
    "            jurisdictions[jurisdiction] = {'name': jurisdiction, 'count': new_count, 'oldest_case_id': id,\n",
    "                                           'oldest_case_name': name, 'oldest_case_date': date,\n",
    "                                           'oldest_case_url': url}\n",
    "\n",
    "print('Results for keyword: ' + keyword)\n",
    "print('Total cases: ' + str(results_count))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Jurisdiction-by-Jurisdiction Results\n",
      "\n",
      "Mass.: 7\n",
      "Oldest case: Briggs v. Leverett(1675-07-27)\n",
      "Link: https://api.case.law/v1/cases/12070732/\n",
      "\n",
      "\n",
      "Md.: 3\n",
      "Oldest case: Johnson’s Lessee v. Kraner(1788-10)\n",
      "Link: https://api.case.law/v1/cases/1034759/\n",
      "\n",
      "\n",
      "N.J.: 2\n",
      "Oldest case: State v. Wells(1790-09)\n",
      "Link: https://api.case.law/v1/cases/321945/\n",
      "\n",
      "\n",
      "Va.: 3\n",
      "Oldest case: White v. Jones(1792-10)\n",
      "Link: https://api.case.law/v1/cases/1964199/\n",
      "\n",
      "\n",
      "Pa.: 9\n",
      "Oldest case: Clarke v. M‘Intire(1794-06)\n",
      "Link: https://api.case.law/v1/cases/12130675/\n",
      "\n",
      "\n",
      "U.S.: 11\n",
      "Oldest case: United States v. Bank of Alexandria(1801-04)\n",
      "Link: https://api.case.law/v1/cases/6639509/\n",
      "\n",
      "\n",
      "N.Y.: 3\n",
      "Oldest case: Mayell v. Potter(1801-10)\n",
      "Link: https://api.case.law/v1/cases/1890637/\n",
      "\n",
      "\n",
      "Ky.: 7\n",
      "Oldest case: Speed v. Lewis(1808)\n",
      "Link: https://api.case.law/v1/cases/6686656/\n",
      "\n",
      "\n",
      "Conn.: 7\n",
      "Oldest case: Hicock v. Hoskins(1809-06)\n",
      "Link: https://api.case.law/v1/cases/6753295/\n",
      "\n",
      "\n",
      "N.H.: 2\n",
      "Oldest case: Trustees of Dartmouth College v. Woodward(1817-11)\n",
      "Link: https://api.case.law/v1/cases/2361845/\n",
      "\n",
      "\n",
      "S.C.: 6\n",
      "Oldest case: Welch v. Phillips(1821-05)\n",
      "Link: https://api.case.law/v1/cases/8858741/\n",
      "\n",
      "\n",
      "N.C.: 3\n",
      "Oldest case: State v. Reed(1823-06)\n",
      "Link: https://api.case.law/v1/cases/11276857/\n",
      "\n",
      "\n",
      "Ala.: 3\n",
      "Oldest case: Jones v. Watkins(1827-01)\n",
      "Link: https://api.case.law/v1/cases/8493229/\n",
      "\n",
      "\n",
      "Tenn.: 8\n",
      "Oldest case: Vanzant v. Waddel(1829-01)\n",
      "Link: https://api.case.law/v1/cases/11266317/\n",
      "\n",
      "\n",
      "La.: 3\n",
      "Oldest case: Shepherd & Co. v. Lanfear(1833-03)\n",
      "Link: https://api.case.law/v1/cases/8749962/\n",
      "\n",
      "\n",
      "Del.: 2\n",
      "Oldest case: Hearn v. Ralph(1835)\n",
      "Link: https://api.case.law/v1/cases/1866284/\n",
      "\n",
      "\n",
      "Mo.: 5\n",
      "Oldest case: State ex rel. Gentry v. Fry(1835-08)\n",
      "Link: https://api.case.law/v1/cases/8853250/\n",
      "\n",
      "\n",
      "Mich.: 6\n",
      "Oldest case: United States v. Three Turkeys & A Basket of Salad(1836)\n",
      "Link: https://api.case.law/v1/cases/12097449/\n",
      "\n",
      "\n",
      "Miss.: 3\n",
      "Oldest case: Palmer v. Cross(1843-07)\n",
      "Link: https://api.case.law/v1/cases/1635125/\n",
      "\n",
      "\n",
      "Ill.: 7\n",
      "Oldest case: Rigg v. Cook(1847-12)\n",
      "Link: https://api.case.law/v1/cases/2563196/\n",
      "\n",
      "\n",
      "Ohio: 4\n",
      "Oldest case: Chesnut v. Shane’s Lessee(1847-12)\n",
      "Link: https://api.case.law/v1/cases/494383/\n",
      "\n",
      "\n",
      "Ga.: 3\n",
      "Oldest case: Rouse v. State(1848-01)\n",
      "Link: https://api.case.law/v1/cases/11075348/\n",
      "\n",
      "\n",
      "Fla.: 6\n",
      "Oldest case: Sibley v. Maria(1849-01)\n",
      "Link: https://api.case.law/v1/cases/8849708/\n",
      "\n",
      "\n",
      "Ark.: 7\n",
      "Oldest case: Biscoe v. Stone(1850-01)\n",
      "Link: https://api.case.law/v1/cases/8727394/\n",
      "\n",
      "\n",
      "Wis.: 2\n",
      "Oldest case: In re the County Seat of La Fayette County(1850-06)\n",
      "Link: https://api.case.law/v1/cases/6139952/\n",
      "\n",
      "\n",
      "Tex.: 3\n",
      "Oldest case: State v. Delesdenier(1851)\n",
      "Link: https://api.case.law/v1/cases/6767784/\n",
      "\n",
      "\n",
      "Ind.: 5\n",
      "Oldest case: City of Lafayette v. Cox(1854-05-23)\n",
      "Link: https://api.case.law/v1/cases/1448462/\n",
      "\n",
      "\n",
      "Cal.: 12\n",
      "Oldest case: People ex rel. Kohler v. Hays(1855)\n",
      "Link: https://api.case.law/v1/cases/2276005/\n",
      "\n",
      "\n",
      "Iowa: 2\n",
      "Oldest case: Miller v. Chittenden(1856-06)\n",
      "Link: https://api.case.law/v1/cases/2268318/\n",
      "\n",
      "\n",
      "R.I.: 1\n",
      "Oldest case: State v. Fitzpatrick(1856-09)\n",
      "Link: https://api.case.law/v1/cases/720692/\n",
      "\n",
      "\n",
      "Vt.: 1\n",
      "Oldest case: Keyes v. Hill(1858-08)\n",
      "Link: https://api.case.law/v1/cases/741818/\n",
      "\n",
      "\n",
      "Kan.: 4\n",
      "Oldest case: Parker v. Hays(1871-01)\n",
      "Link: https://api.case.law/v1/cases/90729/\n",
      "\n",
      "\n",
      "D.C.: 2\n",
      "Oldest case: Dainese v. Hale(1873-04)\n",
      "Link: https://api.case.law/v1/cases/2479659/\n",
      "\n",
      "\n",
      "Neb.: 5\n",
      "Oldest case: Sovereign v. State(1878-07)\n",
      "Link: https://api.case.law/v1/cases/5379066/\n",
      "\n",
      "\n",
      "Colo.: 2\n",
      "Oldest case: Martin v. McLaughlin(1880-12)\n",
      "Link: https://api.case.law/v1/cases/193375/\n",
      "\n",
      "\n",
      "Haw.: 3\n",
      "Oldest case: The King v. Manu(1881-04-22)\n",
      "Link: https://api.case.law/v1/cases/8826881/\n",
      "\n",
      "\n",
      "W. Va.: 16\n",
      "Oldest case: State v. Chambers(1883-10-27)\n",
      "Link: https://api.case.law/v1/cases/8641000/\n",
      "\n",
      "\n",
      "Mont.: 3\n",
      "Oldest case: Territory v. Hart(1888-01)\n",
      "Link: https://api.case.law/v1/cases/2282352/\n",
      "\n",
      "\n",
      "Me.: 2\n",
      "Oldest case: Moore v. Alden(1888-03-14)\n",
      "Link: https://api.case.law/v1/cases/487526/\n",
      "\n",
      "\n",
      "Or.: 9\n",
      "Oldest case: State v. Olds(1890-07-01)\n",
      "Link: https://api.case.law/v1/cases/8662364/\n",
      "\n",
      "\n",
      "Ariz.: 7\n",
      "Oldest case: Territory of Arizona v. Chartz(1893-01)\n",
      "Link: https://api.case.law/v1/cases/2887901/\n",
      "\n",
      "\n",
      "N.D.: 5\n",
      "Oldest case: Lay v. Emery(1899-07-01)\n",
      "Link: https://api.case.law/v1/cases/5296344/\n",
      "\n",
      "\n",
      "Okla.: 3\n",
      "Oldest case: Cameron v. Territory of Oklahoma(1906-02-15)\n",
      "Link: https://api.case.law/v1/cases/8879266/\n",
      "\n",
      "\n",
      "Wash.: 5\n",
      "Oldest case: Shepard v. Minneapolis Threshing Machine Co.(1908-08-17)\n",
      "Link: https://api.case.law/v1/cases/546021/\n",
      "\n",
      "\n",
      "Wyo.: 5\n",
      "Oldest case: State v. Kelley(1909-01-09)\n",
      "Link: https://api.case.law/v1/cases/8515974/\n",
      "\n",
      "\n",
      "Nev.: 5\n",
      "Oldest case: State v. Clark(1909-10)\n",
      "Link: https://api.case.law/v1/cases/8577250/\n",
      "\n",
      "\n",
      "Minn.: 5\n",
      "Oldest case: Sheehy v. Whipps(1913-06-06)\n",
      "Link: https://api.case.law/v1/cases/207851/\n",
      "\n",
      "\n",
      "S.D.: 2\n",
      "Oldest case: Dunlap v. Chicago, M. & St. P. Ry. Co.(1913-12-05)\n",
      "Link: https://api.case.law/v1/cases/8517904/\n",
      "\n",
      "\n",
      "N.M.: 2\n",
      "Oldest case: State v. Massey(1927-05-02)\n",
      "Link: https://api.case.law/v1/cases/1552968/\n",
      "\n",
      "\n",
      "Idaho: 2\n",
      "Oldest case: Lawson v. Robertson(1932-01-25)\n",
      "Link: https://api.case.law/v1/cases/2339209/\n",
      "\n",
      "\n",
      "Utah: 1\n",
      "Oldest case: Scoville v. Kellogg Sales Co.(1953-10-16)\n",
      "Link: https://api.case.law/v1/cases/62858/\n",
      "\n",
      "\n",
      "Alaska: 3\n",
      "Oldest case: Baker v. City of Fairbanks(1970-06-05)\n",
      "Link: https://api.case.law/v1/cases/10563444/\n",
      "\n",
      "\n",
      "V.I.: 1\n",
      "Oldest case: Saldana v. Kmart Corp.(1999-12-20)\n",
      "Link: https://api.case.law/v1/cases/233306/\n",
      "\n",
      "\n"
     ]
    }
   ],
   "source": [
    "results_sorted = OrderedDict(sorted(jurisdictions.items(), key=lambda kv: kv[1]['oldest_case_date']))\n",
    "print('Jurisdiction-by-Jurisdiction Results' + '\\n')\n",
    "\n",
    "for values in results_sorted.values():\n",
    "    print(values['name'] + ': ' + str(values['count']))\n",
    "    print('Oldest case: ' + values['oldest_case_name'] + '(' + values['oldest_case_date'] + ')')\n",
    "    print('Link: ' + values['oldest_case_url'])\n",
    "    print('\\n')"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.5.4"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}