{
    "info": {
        "author": "Kelvin Gakuo",
        "author_email": "kelvingakuo@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: MIT License",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3.5"
        ],
        "description": "# fycharts\nA fully-fledged installable python package for extracting **top 200** and **viral 50** charts off of [spotifycharts.com](http://spotifycharts.com)\n\nIn a nutshell, the unofficial Spotify Charts API\n\n## INSPIRATION\nThis was built to fill the gap left when Spotify deprecated their official Spotify charts API. It arose as a needed crawler for the Spotify data analysis and machine learning project done [here](https://kelvingakuo.github.io)\n\n## INSTALLATION\n```bash\npip install fycharts\n```\n\n## SAMPLE USAGE\nSay you want to extract top 200 daily charts for all time, all regions\n```python\nmyCrawler.py\n\n\nfrom fycharts import SpotifyCharts \n\napi = SpotifyCharts.SpotifyCharts()\napi.top200Daily(output_file = 'top_200_daily.csv')\n```\nRun your program. \n```bash\npython myCrawler.py\n```\nWatch the terminal for helpful information.\n\n## FUNCTIONS AND PARAMETERS\nFour functions, for all data you need are required:\n1. top200Weekly\n2. top200Daily\n3. viral50Weekly\n4. viral50Daily\n\nAll four functions take the following parameters:\n#### Compulsory\n1. output_file - CSV file to dump the data. \n\n#### Optional\n1. start - Start date of range of interest as string YYYY-MM-DD\n2. end - End date of range of interest as string YYYY-MM-DD\n3. region - Region of interest, as a country abbreviation code. 'global' is also valid\n\n**Refer to 'SUPPORTED COUNTRY CODES SO FAR' below for important information of this.**\n\nIf not included, data is extracted for all dates, all regions\n\n## DATA RETURNED\nThe data extracted from spotifycharts.com is written into a CSV file with the following fields:\n1. position - The song's position during that week or day\n2. track name - Name of the song\n3. artist - Name of artist\n4. region - Region of the chart as a code\n5. date - Date or range of dates of chart\n6. id - Spotify track id\n7. streams - Number of streams for that week or day. **Only applicable to top 200 charts**\n\n## SUPPORTED COUNTRY CODES SO FAR\n|   |   |   |   |   |   |   |   |\n|---|---|---|---|---|---|---|---|\n|ad |ca |dk |gr |is |mx |ph |sv |\n|ar |ch |do |gt |it |my |pl |th |\n|at |cl |ec |hk |jp |ni |pt |tr |\n|au |co |ee |hn |lt |nl |py |tw |\n|be |cr |es |hu |lu |no |ro |us |\n|bg |cy |fi |id |lv |nz |se |uy |\n|bo |cz |fr |ie |mc |pa |sg |vn |\n|br |de |gb |il |mt |pe |sk |global|\n\n## PASSING DATES AS PARAMETERS\nIf the date isn't valid, you shall be notified with a list of the closest dates to what you put in, as suggestions.\n\n\n## STUFF YOU SHOULD KNOW\nWhen extracting data for a range of dates, in loop, the crawler sleeps every iteration for a random number of seconds between 0 and the index of the date. Dig into the code to change this!!!\n\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/kelvingakuo/fycharts",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "fycharts",
        "package_url": "https://pypi.org/project/fycharts/",
        "platform": "",
        "project_url": "https://pypi.org/project/fycharts/",
        "project_urls": {
            "Homepage": "https://github.com/kelvingakuo/fycharts"
        },
        "release_url": "https://pypi.org/project/fycharts/1.2.0/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "A fully-fledged installable python package for extracting top 200 and viral 50 charts off of spotifycharts.com",
        "version": "1.2.0"
    },
    "last_serial": 5101229,
    "releases": {
        "1.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b3e9f45ad588bac081320a7fa617d4f1",
                    "sha256": "2773f41cd7c94b928da21aafd9953ac66bfb318f6f3a9d7565281ccc964801bd"
                },
                "downloads": -1,
                "filename": "fycharts-1.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b3e9f45ad588bac081320a7fa617d4f1",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 8408,
                "upload_time": "2019-01-05T00:17:17",
                "url": "https://files.pythonhosted.org/packages/a6/82/94980b505f84d4970fe7d6770a4d47822e2f197812d420fc3b9b0032381e/fycharts-1.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "d36e7f8ba88df34e9c4c948040d3f7df",
                    "sha256": "7aed1339e9aae7780579329389d8da226e11afd38ac263ee6615537ade34f979"
                },
                "downloads": -1,
                "filename": "fycharts-1.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "d36e7f8ba88df34e9c4c948040d3f7df",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6148,
                "upload_time": "2019-01-05T00:17:20",
                "url": "https://files.pythonhosted.org/packages/f7/dc/e3ec7e8e9454c24d0731a30447552c0f5d3129bf6557e69929b1de6f2387/fycharts-1.0.1.tar.gz"
            }
        ],
        "1.1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "bb0fce142488d64ebfa48c72e916b554",
                    "sha256": "63f3125969575ce1be775bd9b7b3fa866efbda8838ba565163106f8e5a3d64a3"
                },
                "downloads": -1,
                "filename": "fycharts-1.1.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "bb0fce142488d64ebfa48c72e916b554",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 8379,
                "upload_time": "2019-01-05T00:27:15",
                "url": "https://files.pythonhosted.org/packages/6c/fa/dd0a811c4b24ab1c0cec03c709a5a8e750cb8f38919d6633c68a8d11882d/fycharts-1.1.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "f3d98c65d8b5194c6fa17191b2dae7d2",
                    "sha256": "24915c10835636118da57dc270ce313d9009a54f0664c68010eeee5191e4e51d"
                },
                "downloads": -1,
                "filename": "fycharts-1.1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "f3d98c65d8b5194c6fa17191b2dae7d2",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6098,
                "upload_time": "2019-01-05T00:27:17",
                "url": "https://files.pythonhosted.org/packages/05/b4/da5dab3f2f3f7cbbe82c571519de28245dacf8c702c5887a3193d4cf94ad/fycharts-1.1.1.tar.gz"
            }
        ],
        "1.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "de6fe759ef7e3a1817db4800f4ca602a",
                    "sha256": "635291f2ed014fae80b7e8c75ff07fdfae9f59fe038a0749f3475f2afa0d2994"
                },
                "downloads": -1,
                "filename": "fycharts-1.2.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "de6fe759ef7e3a1817db4800f4ca602a",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 7445,
                "upload_time": "2019-04-04T22:41:00",
                "url": "https://files.pythonhosted.org/packages/85/c6/afbc47f4c0b6da96e2f8969e174f01686a2eeaa6e0d95c2148364935d3b9/fycharts-1.2.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "8a621597acec240c9dbc85432298ef0a",
                    "sha256": "6680fad43ba6311471b4ce97f455e93114ae6e01cd997919b0f9552ef4b2f286"
                },
                "downloads": -1,
                "filename": "fycharts-1.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "8a621597acec240c9dbc85432298ef0a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6080,
                "upload_time": "2019-04-04T22:41:02",
                "url": "https://files.pythonhosted.org/packages/11/25/ce2b3dbba3c409807025ca5fb69dd28218037b7189b32b907f0093a72c50/fycharts-1.2.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "de6fe759ef7e3a1817db4800f4ca602a",
                "sha256": "635291f2ed014fae80b7e8c75ff07fdfae9f59fe038a0749f3475f2afa0d2994"
            },
            "downloads": -1,
            "filename": "fycharts-1.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "de6fe759ef7e3a1817db4800f4ca602a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 7445,
            "upload_time": "2019-04-04T22:41:00",
            "url": "https://files.pythonhosted.org/packages/85/c6/afbc47f4c0b6da96e2f8969e174f01686a2eeaa6e0d95c2148364935d3b9/fycharts-1.2.0-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "8a621597acec240c9dbc85432298ef0a",
                "sha256": "6680fad43ba6311471b4ce97f455e93114ae6e01cd997919b0f9552ef4b2f286"
            },
            "downloads": -1,
            "filename": "fycharts-1.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "8a621597acec240c9dbc85432298ef0a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 6080,
            "upload_time": "2019-04-04T22:41:02",
            "url": "https://files.pythonhosted.org/packages/11/25/ce2b3dbba3c409807025ca5fb69dd28218037b7189b32b907f0093a72c50/fycharts-1.2.0.tar.gz"
        }
    ]
}