[CarJam](https://www.carjam.co.nz/) is a resource for finding information about cars registered in NZ.
This unofficial python API allows you to interact with the site and retrieve data to use in other python projects.
This API may stop functioning if CarJam updates their website code.
It is provided "as-is" with no implied warranty.
No responsibility is assumed for any future issues or interruptions in API functionality as a result of using this library.
Find this library on PyPi [here](https://pypi.org/project/carjam/) and Github [here](https://github.com/kianz20/CarJam-API)
## Installation
`pip install carjam`
## Basic car details
```python
import carjam
client = carjam.Client()
details = client.basic_details('fkk351')
```
Returns an json object containing basic car details:
```json
{
"plate": "FKK351",
"vin": "7AT0H63WX10005902",
"chassis": "ACT10-0005902",
"current_vehicle_odometer_unit": "K",
"reported_stolen": "U",
"make": "TOYOTA",
"year_of_manufacture": 2000,
"vehicle_type": 7,
"usage_level": 1.91,
"average_fleet_mileage": 10500
}
```
## Car model details
```python
import carjam
client = carjam.Client()
details = client.model_details('fkk351')
```
Returns a json object containing more specific model details:
```json
{
"car_id": 0,
"chassis_number": "ACT10-0005902",
"make": "TOYOTA",
"model": "OPA",
"grade": "I",
"manufacture_date": "2000-09",
"body": "TA-ACT10",
"engine": "1AZFSE",
"drive": "FF",
"transmission": "CVT"
}
```
## Car fuel consumption
```python
import carjam
client = carjam.Client()
fuel_consumption = client.fuel_consumption("fkk351")
```
Returns a string containing the fuel consumption of the car in l/100km:
```txt
7.50 litres/100km
```
## Car images
```python
import carjam
client = carjam.Client()
image = client.image('fkk351')
```
Returns a json object containing links to the current and original image
```json
{
"image": "photos.carjam.co.nz/jph/_search_img_catalog_10102041_200404.jpg",
"orig_image": "photos.carjam.co.nz/jph/_search_img_catalog_10102041_200404.jpg"
}
```
## Car Odometer Details
```python
import carjam
client = carjam.Client()
odo_details = client.odometer_history('fkk351')
```
Returns a json object array containing odometer history
```javascript
[
{
"odometer_date": 1678618800,
"odometer_reading": "296662",
"odometer_unit": "K",
"odometer_source": "IW",
"days": 7,
"seconds": 604800,
"kms": 359,
"daily_usage": 51.285714285714285
},
...
]
```
## NZ Fleet Details
```python
import carjam
client = carjam.Client()
fleet_details = client.fleet_details(page=1)
```
Returns a JSON object containing the most registered cars in NZ, with 20 objects per call.
You can change the page parameter to retrieve additional sets of data.
```javascript
[
{
"make": "FORD",
"model": "RANGER",
"year": "2021",
"count": "12463",
"rank": "1"
},
...
]
```
fleet_details() can also take optional filter variables:
```python
import carjam
client = carjam.Client()
filtered_fleet_details = client.fleet_details(page=1, make='TOYOTA', query="cor", fuel_type="PETROL")
```
Returns a JSON object containing the most registered cars in NZ filtered by the params, with 20 objects per call.
You can change the page parameter to retrieve additional sets of data.
```javascript
[
{
"make": "TOYOTA",
"model": "COROLLA",
"year": "2004",
"count": "8428",
"rank": "17"
},
...
]
```
## Development and Contribution
I welcome any contributions to this project, so feel free!
Raw data
{
"_id": null,
"home_page": "https://github.com/kianz20/CarJam-API",
"name": "carjam",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Kian Jazayeri",
"author_email": "kianja02@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a4/6e/360cd0f16084bac5208e4908804baa79ab36e28e9103229175bef149f26a/carjam-1.0.2.post1.tar.gz",
"platform": null,
"description": "[CarJam](https://www.carjam.co.nz/) is a resource for finding information about cars registered in NZ.\r\n\r\nThis unofficial python API allows you to interact with the site and retrieve data to use in other python projects.\r\n\r\nThis API may stop functioning if CarJam updates their website code.\r\nIt is provided \"as-is\" with no implied warranty.\r\nNo responsibility is assumed for any future issues or interruptions in API functionality as a result of using this library.\r\n\r\nFind this library on PyPi [here](https://pypi.org/project/carjam/) and Github [here](https://github.com/kianz20/CarJam-API)\r\n\r\n## Installation\r\n\r\n`pip install carjam`\r\n\r\n## Basic car details\r\n\r\n```python\r\nimport carjam\r\nclient = carjam.Client()\r\ndetails = client.basic_details('fkk351')\r\n```\r\n\r\nReturns an json object containing basic car details:\r\n\r\n```json\r\n{\r\n\t\"plate\": \"FKK351\",\r\n\t\"vin\": \"7AT0H63WX10005902\",\r\n\t\"chassis\": \"ACT10-0005902\",\r\n\t\"current_vehicle_odometer_unit\": \"K\",\r\n\t\"reported_stolen\": \"U\",\r\n\t\"make\": \"TOYOTA\",\r\n\t\"year_of_manufacture\": 2000,\r\n\t\"vehicle_type\": 7,\r\n\t\"usage_level\": 1.91,\r\n\t\"average_fleet_mileage\": 10500\r\n}\r\n```\r\n\r\n## Car model details\r\n\r\n```python\r\nimport carjam\r\nclient = carjam.Client()\r\ndetails = client.model_details('fkk351')\r\n```\r\n\r\nReturns a json object containing more specific model details:\r\n\r\n```json\r\n{\r\n\t\"car_id\": 0,\r\n\t\"chassis_number\": \"ACT10-0005902\",\r\n\t\"make\": \"TOYOTA\",\r\n\t\"model\": \"OPA\",\r\n\t\"grade\": \"I\",\r\n\t\"manufacture_date\": \"2000-09\",\r\n\t\"body\": \"TA-ACT10\",\r\n\t\"engine\": \"1AZFSE\",\r\n\t\"drive\": \"FF\",\r\n\t\"transmission\": \"CVT\"\r\n}\r\n```\r\n\r\n## Car fuel consumption\r\n\r\n```python\r\nimport carjam\r\nclient = carjam.Client()\r\nfuel_consumption = client.fuel_consumption(\"fkk351\")\r\n```\r\n\r\nReturns a string containing the fuel consumption of the car in l/100km:\r\n\r\n```txt\r\n7.50 litres/100km\r\n```\r\n\r\n## Car images\r\n\r\n```python\r\nimport carjam\r\nclient = carjam.Client()\r\nimage = client.image('fkk351')\r\n```\r\n\r\nReturns a json object containing links to the current and original image\r\n\r\n```json\r\n{\r\n\t\"image\": \"photos.carjam.co.nz/jph/_search_img_catalog_10102041_200404.jpg\",\r\n\t\"orig_image\": \"photos.carjam.co.nz/jph/_search_img_catalog_10102041_200404.jpg\"\r\n}\r\n```\r\n\r\n## Car Odometer Details\r\n\r\n```python\r\nimport carjam\r\nclient = carjam.Client()\r\nodo_details = client.odometer_history('fkk351')\r\n```\r\n\r\nReturns a json object array containing odometer history\r\n\r\n```javascript\r\n[\r\n {\r\n \"odometer_date\": 1678618800,\r\n \"odometer_reading\": \"296662\",\r\n \"odometer_unit\": \"K\",\r\n \"odometer_source\": \"IW\",\r\n \"days\": 7,\r\n \"seconds\": 604800,\r\n \"kms\": 359,\r\n \"daily_usage\": 51.285714285714285\r\n },\r\n ...\r\n]\r\n```\r\n\r\n## NZ Fleet Details\r\n\r\n```python\r\nimport carjam\r\nclient = carjam.Client()\r\nfleet_details = client.fleet_details(page=1)\r\n```\r\n\r\nReturns a JSON object containing the most registered cars in NZ, with 20 objects per call.\r\nYou can change the page parameter to retrieve additional sets of data.\r\n\r\n```javascript\r\n[\r\n {\r\n \"make\": \"FORD\",\r\n \"model\": \"RANGER\",\r\n \"year\": \"2021\",\r\n \"count\": \"12463\",\r\n \"rank\": \"1\"\r\n },\r\n ...\r\n]\r\n```\r\n\r\nfleet_details() can also take optional filter variables:\r\n\r\n```python\r\nimport carjam\r\nclient = carjam.Client()\r\nfiltered_fleet_details = client.fleet_details(page=1, make='TOYOTA', query=\"cor\", fuel_type=\"PETROL\")\r\n```\r\n\r\nReturns a JSON object containing the most registered cars in NZ filtered by the params, with 20 objects per call.\r\nYou can change the page parameter to retrieve additional sets of data.\r\n\r\n```javascript\r\n[\r\n {\r\n \"make\": \"TOYOTA\",\r\n \"model\": \"COROLLA\",\r\n \"year\": \"2004\",\r\n \"count\": \"8428\",\r\n \"rank\": \"17\"\r\n },\r\n ...\r\n]\r\n```\r\n\r\n## Development and Contribution\r\n\r\nI welcome any contributions to this project, so feel free!\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Unoffical Python API for CarJam NZ",
"version": "1.0.2.post1",
"project_urls": {
"Homepage": "https://github.com/kianz20/CarJam-API"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "19d56b225dd3b2725fe3c6bf382a9f51d73d04efb0a4118bab09353fe1e5a8dc",
"md5": "7eb02e39783f9bfe784845041d6464e1",
"sha256": "fa25e0dd93c5dab17edf410656a8bcc584b46919937670d5b84fbe09e4ad6276"
},
"downloads": -1,
"filename": "carjam-1.0.2.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7eb02e39783f9bfe784845041d6464e1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5791,
"upload_time": "2024-09-25T10:59:36",
"upload_time_iso_8601": "2024-09-25T10:59:36.910316Z",
"url": "https://files.pythonhosted.org/packages/19/d5/6b225dd3b2725fe3c6bf382a9f51d73d04efb0a4118bab09353fe1e5a8dc/carjam-1.0.2.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a46e360cd0f16084bac5208e4908804baa79ab36e28e9103229175bef149f26a",
"md5": "11df4b4e8e473fb85f2905dca15f6bc2",
"sha256": "bb48051dd0a568646b7581275b69658fe4a375cfb3a5e2ac97fdd040dc723541"
},
"downloads": -1,
"filename": "carjam-1.0.2.post1.tar.gz",
"has_sig": false,
"md5_digest": "11df4b4e8e473fb85f2905dca15f6bc2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6679,
"upload_time": "2024-09-25T10:59:38",
"upload_time_iso_8601": "2024-09-25T10:59:38.597855Z",
"url": "https://files.pythonhosted.org/packages/a4/6e/360cd0f16084bac5208e4908804baa79ab36e28e9103229175bef149f26a/carjam-1.0.2.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-25 10:59:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kianz20",
"github_project": "CarJam-API",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "carjam"
}
JSON
