# court_listener
`court_listener` is a Python client library for interacting with the Court Listener API. It provides an easy way to access and query court data from the Court Listener API, which offers access to a wealth of legal information including case law, opinions, and more.
## Features
- **Simple API Interaction**: Easily interact with the Court Listener API using a straightforward Python client.
- **Prettified JSON Output**: By default JSON responses are prettified for better readability. This can be changed by setting prettify to False in the class constructor.
- **Error Handling**: Includes built-in error handling to manage API request issues gracefully.
## Installation
You can install `court_listener` via pip:
```bash
pip install court-listener
```
## Usage
### Making API Requests
You can interact with different API endpoints using specialized classes provided within the `apis` module. For example, to use the search functionality:
```python
from court_listener.apis.search import Search
search_client = Search(api_key="your_api_key")
response = search_client.get_search(query="case law", start_date="2023-01-01", end_date="2023-12-31")
print(response)
```
## Error Handling
The library includes error handling to manage potential issues with API requests. Ensure that any API errors are handled appropriately in your implementation.
## Court Listener Documentation
Users should reference the Court Listener docs for more information. According to the docs, "Our APIs allow 5,000 queries per hour to authenticated users. Unauthenticated users are allowed 100 queries per day for experimentation." To read further and get your own api key, visit their site [here](https://www.courtlistener.com/help/api/rest/)
## Contributing
Contributions are welcome! Please submit issues or pull requests on [GitHub](https://github.com/SpyderRex/court_listener).
## License
`court_listener` is open-source software licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contact
For questions or support, please contact [billyjohnsonauthor@gmail.com](mailto: billyjohnsonauthor@gmail.com).
Raw data
{
"_id": null,
"home_page": "https://github.com/SpyderRex/court-listener",
"name": "court-listener",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "API, requests, client, courts, legal, law",
"author": "Spyder Rex",
"author_email": "billyjohnsonauthor@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b3/c2/eec7da40ef3ce6341c17b58182588ef86c513f7bf495276be218a94fa4ec/court_listener-0.0.1.tar.gz",
"platform": null,
"description": "# court_listener\n\n`court_listener` is a Python client library for interacting with the Court Listener API. It provides an easy way to access and query court data from the Court Listener API, which offers access to a wealth of legal information including case law, opinions, and more.\n\n## Features\n\n- **Simple API Interaction**: Easily interact with the Court Listener API using a straightforward Python client.\n- **Prettified JSON Output**: By default JSON responses are prettified for better readability. This can be changed by setting prettify to False in the class constructor.\n- **Error Handling**: Includes built-in error handling to manage API request issues gracefully.\n\n## Installation\n\nYou can install `court_listener` via pip:\n\n```bash\npip install court-listener\n```\n\n## Usage\n\n### Making API Requests\n\nYou can interact with different API endpoints using specialized classes provided within the `apis` module. For example, to use the search functionality:\n\n```python\nfrom court_listener.apis.search import Search\n\nsearch_client = Search(api_key=\"your_api_key\")\nresponse = search_client.get_search(query=\"case law\", start_date=\"2023-01-01\", end_date=\"2023-12-31\")\nprint(response)\n```\n\n## Error Handling\n\nThe library includes error handling to manage potential issues with API requests. Ensure that any API errors are handled appropriately in your implementation.\n\n## Court Listener Documentation\n\nUsers should reference the Court Listener docs for more information. According to the docs, \"Our APIs allow 5,000 queries per hour to authenticated users. Unauthenticated users are allowed 100 queries per day for experimentation.\" To read further and get your own api key, visit their site [here](https://www.courtlistener.com/help/api/rest/)\n\n## Contributing\n\nContributions are welcome! Please submit issues or pull requests on [GitHub](https://github.com/SpyderRex/court_listener).\n\n## License\n\n`court_listener` is open-source software licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor questions or support, please contact [billyjohnsonauthor@gmail.com](mailto: billyjohnsonauthor@gmail.com).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python client for the Court Listener API",
"version": "0.0.1",
"project_urls": {
"Homepage": "https://github.com/SpyderRex/court-listener",
"Repository": "https://github.com/SpyderRex/court-listener"
},
"split_keywords": [
"api",
" requests",
" client",
" courts",
" legal",
" law"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7216b67e20150d529031fdbc3ab32d5f7f5c9bca24ade825b4862893cb992030",
"md5": "cfa29246ed529c34ae9ba8cc246dc02b",
"sha256": "bc2f91489cab7154e1d63e06aad393eca4261d9337ecad4e4d0817a907487353"
},
"downloads": -1,
"filename": "court_listener-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cfa29246ed529c34ae9ba8cc246dc02b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 16595,
"upload_time": "2024-09-04T00:40:07",
"upload_time_iso_8601": "2024-09-04T00:40:07.312356Z",
"url": "https://files.pythonhosted.org/packages/72/16/b67e20150d529031fdbc3ab32d5f7f5c9bca24ade825b4862893cb992030/court_listener-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b3c2eec7da40ef3ce6341c17b58182588ef86c513f7bf495276be218a94fa4ec",
"md5": "deb218b4260484c28701cb03ee2432fa",
"sha256": "3f1d2393ede0311709dbfa819d453b2fdf3d9b4a7aaaf822010f00d51d816c60"
},
"downloads": -1,
"filename": "court_listener-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "deb218b4260484c28701cb03ee2432fa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 9288,
"upload_time": "2024-09-04T00:40:09",
"upload_time_iso_8601": "2024-09-04T00:40:09.210684Z",
"url": "https://files.pythonhosted.org/packages/b3/c2/eec7da40ef3ce6341c17b58182588ef86c513f7bf495276be218a94fa4ec/court_listener-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-04 00:40:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SpyderRex",
"github_project": "court-listener",
"github_not_found": true,
"lcname": "court-listener"
}
JSON
