{"id":20590057,"url":"https://github.com/doist/todoist-api-python","last_synced_at":"2025-05-15T22:05:03.940Z","repository":{"id":37905039,"uuid":"428678412","full_name":"Doist/todoist-api-python","owner":"Doist","description":"A python wrapper for the Todoist REST API.","archived":false,"fork":false,"pushed_at":"2025-05-08T00:09:59.000Z","size":1425,"stargazers_count":208,"open_issues_count":4,"forks_count":28,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-15T22:04:31.673Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Doist.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-11-16T14:02:16.000Z","updated_at":"2025-05-08T00:09:41.000Z","dependencies_parsed_at":"2023-10-23T01:29:19.840Z","dependency_job_id":"6a37519d-4e01-48c3-8739-b0fbe8c4c06e","html_url":"https://github.com/Doist/todoist-api-python","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Ftodoist-api-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Ftodoist-api-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Ftodoist-api-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Doist%2Ftodoist-api-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Doist","download_url":"https://codeload.github.com/Doist/todoist-api-python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254430326,"owners_count":22069907,"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":[],"created_at":"2024-11-16T07:33:48.385Z","updated_at":"2025-05-15T22:05:03.931Z","avatar_url":"https://github.com/Doist.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Todoist API Python Client\n\nThis is the official Python SDK for the Todoist API.\n\n## Installation\n\n```bash\npip install todoist-api-python\n```\n\nOr add the project as a dependency in `pyproject.toml`:\n\n```toml\ndependencies = [\n  \"todoist-api-python\u003e=3.1.0,\u003c4\",\n]\n```\n\n### Supported Python Versions\n\nPython version 3.9 and above.\n\n## Usage\n\nHere's an example of initializing the API client, fetching a task, and paginating through its comments:\n\n```python\nfrom todoist_api_python.api import TodoistAPI\n\napi = TodoistAPI(\"YOUR_API_TOKEN\")\n\ntask = api.get_task(\"6X4Vw2Hfmg73Q2XR\")\nprint(f\"Task: {task.content}\")\n\ncomments_iter = api.get_comments(task_id=task.id)\nfor comments in comments_iter:\n    for comment in comments:\n        print(f\"Comment: {comment.content}\")\n```\n\n## Documentation\n\nFor more detailed reference documentation, have a look at the [SDK documentation](https://doist.github.io/todoist-api-python/) and the [API documentation](https://developer.todoist.com).\n\n## Development\n\nTo install Python dependencies:\n\n```sh\n$ uv sync\n```\n\nTo install pre-commit:\n\n```sh\n$ uv run pre-commit install\n```\n\nYou can try your changes via REPL by running:\n\n```sh\n$ uv run python\n```\n\nYou can then import the library as described in [Usage](#usage) without having to create a file.\nIf you decide to use `TodoistAPIAsync`, please keep in mind that you have to `import asyncio`\nand run `asyncio.run(yourmethod())` to make your async methods run as expected.\n\n### Releases\n\nThis API client is public, and available in a PyPI repository.\n\nA new update is automatically released by GitHub Actions, by creating a release with a tag in the format `vX.Y.Z` (`v\u003cMajor\u003e.\u003cMinor\u003e.\u003cPatch\u003e`).\n\nUsers of the API client can then update to the new version in their `pyproject.toml` file.\n\n## Feedback\n\nAny feedback, bugs, questions, comments, etc., can be reported as *Issues* in this repository.\n\n### Contributions\n\nWe would love contributions! *Pull requests* are welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoist%2Ftodoist-api-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoist%2Ftodoist-api-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoist%2Ftodoist-api-python/lists"}