{"id":15009741,"url":"https://github.com/petitpotiron/python-convertio","last_synced_at":"2025-09-06T08:44:38.625Z","repository":{"id":45195313,"uuid":"415270108","full_name":"PetitPotiron/python-convertio","owner":"PetitPotiron","description":"An API wrapper for @convertio (convertio.co) written in Python. ","archived":false,"fork":false,"pushed_at":"2023-12-03T18:06:42.000Z","size":107,"stargazers_count":11,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-23T19:51:32.237Z","etag":null,"topics":["api","api-wrapper","conversion","converter","convertio","file","file-format","hacktoberfest","hacktoberfest2021","py","python","python3"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/convertio/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PetitPotiron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-09T10:00:52.000Z","updated_at":"2024-06-25T20:30:43.000Z","dependencies_parsed_at":"2024-10-12T09:40:39.851Z","dependency_job_id":null,"html_url":"https://github.com/PetitPotiron/python-convertio","commit_stats":{"total_commits":48,"total_committers":4,"mean_commits":12.0,"dds":0.08333333333333337,"last_synced_commit":"53345e7a31fd78f0f8230c5c943c208c5e3e6fb1"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PetitPotiron%2Fpython-convertio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PetitPotiron%2Fpython-convertio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PetitPotiron%2Fpython-convertio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PetitPotiron%2Fpython-convertio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PetitPotiron","download_url":"https://codeload.github.com/PetitPotiron/python-convertio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248083230,"owners_count":21045060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-wrapper","conversion","converter","convertio","file","file-format","hacktoberfest","hacktoberfest2021","py","python","python3"],"created_at":"2024-09-24T19:28:08.519Z","updated_at":"2025-09-06T08:44:38.614Z","avatar_url":"https://github.com/PetitPotiron.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![python-convertio](https://socialify.git.ci/PetitPotiron/python-convertio/image?description=1\u0026font=Bitter\u0026forks=1\u0026issues=1\u0026language=1\u0026name=1\u0026owner=1\u0026pattern=Circuit+Board\u0026pulls=1\u0026stargazers=1\u0026theme=Auto)\r\n# convertio\r\n[![Convertio version on pypi](https://img.shields.io/pypi/v/convertio.svg)](https://pypi.org/project/convertio)\r\n[![Discord support server](https://discord.com/api/guilds/800032961525317693/embed.png)](https://discord.gg/t2dxrXMKya)\r\n\r\nAn API wrapper for convertio.co. Before starting, make sure [you've got an API key](https://developers.convertio.co/user/registration/api?utm_source=api_top_btn). The full API reference can be found on [convertio.co/api/docs](https://convertio.co/api/docs), but I'll make a documentation for this package soon.\r\n\r\n## Get started\r\n- Sign-up to [developers.convertio.co](https://developers.convertio.co/user/registration/api?utm_source=api_top_btn).\r\n- Get your free API key from [the homepage](https://developers.convertio.co)\r\n- Install this module : run `python -m pip install convertio -U` for Windows or `python3 -m pip install convertio -U` for Linux and Macos. You can also download it from github `pip install git+https://github.com/PetitPotiron/python-convertio.git`\r\n\r\n## Quick start\r\n```python\r\nimport convertio\r\nimport time\r\n\r\nclient = convertio.Client(token=\"INSERT_YOUR_TOKEN_HERE\")\r\nconversion_id = client.convert_by_filename('source.txt', 'pdf')\r\nwhile client.check_conversion(conversion_id).step != 'finish':\r\n    time.sleep(1)\r\nclient.download(conversion_id, 'result.pdf')\r\nclient.delete(conversion_id)\r\n```\r\n\r\n\r\n## Notes\r\n\r\nVersion `1.2.0`\r\n\r\nThis module is neither created nor managed by convertio.co. It represents services faithful to the API and documentation from their website. This API is not unofficial, and it can be payable if you exceed a certain usage. Notice that you must respect convertio.co's [terms of use](https://convertio.co/terms).\r\n\r\n### Links\r\n- [Get an API key](https://developers.convertio.co/user/registration/api?utm_source=api_top_btn)\r\n- [API pricing](https://developers.convertio.co/api/pricing)\r\n- [API reference](https://developers.convertio.co/api/docs)\r\n- [OCR (options) pricing](https://developers.convertio.co/ocr/pricing)\r\n- [Conversion types](https://convertio.co/formats)\r\n- [GitHub](https:/github.com/PetitPotiron/python-convertio)\r\n- [PHP module by convertio.co](https://github.com/convertio/convertio-php)\r\n- [CLI for convertio.co, by themselves](https://developers.convertio.co/cli)\r\n\r\n### Changelog\r\n- Fixed error when trying to upload a file of a different format than .txt. It used to be impossible. Added usage example\r\n- [Fix issue #1 (typing does not work on 3.8 and lower)](https://github.com/PetitPotiron/python-convertio/commit/3faddfac11d2d0e055c5b181041fd9d0587c3f46)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetitpotiron%2Fpython-convertio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetitpotiron%2Fpython-convertio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetitpotiron%2Fpython-convertio/lists"}