{"id":13520173,"url":"https://github.com/algolia/algoliasearch-client-python","last_synced_at":"2025-06-19T15:41:41.137Z","repository":{"id":8587621,"uuid":"10221096","full_name":"algolia/algoliasearch-client-python","owner":"algolia","description":"⚡️ A fully-featured and blazing-fast Python API client to interact with Algolia.","archived":false,"fork":false,"pushed_at":"2025-06-18T14:28:11.000Z","size":71120,"stargazers_count":203,"open_issues_count":15,"forks_count":66,"subscribers_count":80,"default_branch":"main","last_synced_at":"2025-06-18T15:35:10.328Z","etag":null,"topics":["algolia","python","search"],"latest_commit_sha":null,"homepage":"https://www.algolia.com/doc/api-client/getting-started/install/python/?language=python","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/algolia.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-05-22T13:57:40.000Z","updated_at":"2025-06-18T14:28:15.000Z","dependencies_parsed_at":"2025-04-14T08:31:23.697Z","dependency_job_id":"8bfba9ca-9d57-463a-94e8-14a0a9a0f20d","html_url":"https://github.com/algolia/algoliasearch-client-python","commit_stats":{"total_commits":933,"total_committers":40,"mean_commits":23.325,"dds":0.6420150053590568,"last_synced_commit":"3bb9108d9dff627f12c921ad23dab02984f70a44"},"previous_names":[],"tags_count":179,"template":false,"template_full_name":null,"purl":"pkg:github/algolia/algoliasearch-client-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algolia%2Falgoliasearch-client-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algolia%2Falgoliasearch-client-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algolia%2Falgoliasearch-client-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algolia%2Falgoliasearch-client-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/algolia","download_url":"https://codeload.github.com/algolia/algoliasearch-client-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algolia%2Falgoliasearch-client-python/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260781324,"owners_count":23062211,"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":["algolia","python","search"],"created_at":"2024-08-01T05:02:13.301Z","updated_at":"2025-06-19T15:41:36.086Z","avatar_url":"https://github.com/algolia.png","language":"Python","funding_links":[],"categories":["Python","API Clients"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.algolia.com\"\u003e\n    \u003cimg alt=\"Algolia for Python\" src=\"https://raw.githubusercontent.com/algolia/algoliasearch-client-common/master/banners/python.png\" \u003e\n  \u003c/a\u003e\n\n  \u003ch4 align=\"center\"\u003eThe perfect starting point to integrate \u003ca href=\"https://algolia.com\" target=\"_blank\"\u003eAlgolia\u003c/a\u003e within your Python project\u003c/h4\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pypi.org/project/algoliasearch\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/algoliasearch.svg\" alt=\"PyPI\"\u003e\u003c/img\u003e\u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/algoliasearch\"\u003e\u003cimg src=\"https://img.shields.io/pypi/pyversions/ansicolortags.svg\" alt=\"Python versions\"\u003e\u003c/img\u003e\u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/algoliasearch\"\u003e\u003cimg src=\"https://img.shields.io/pypi/l/ansicolortags.svg\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.algolia.com/doc/libraries/python/\" target=\"_blank\"\u003eDocumentation\u003c/a\u003e  •\n  \u003ca href=\"https://github.com/algolia/algoliasearch-django\" target=\"_blank\"\u003eDjango\u003c/a\u003e  •\n  \u003ca href=\"https://discourse.algolia.com\" target=\"_blank\"\u003eCommunity Forum\u003c/a\u003e  •\n  \u003ca href=\"http://stackoverflow.com/questions/tagged/algolia\" target=\"_blank\"\u003eStack Overflow\u003c/a\u003e  •\n  \u003ca href=\"https://github.com/algolia/algoliasearch-client-python/issues\" target=\"_blank\"\u003eReport a bug\u003c/a\u003e  •\n  \u003ca href=\"https://www.algolia.com/doc/api-client/troubleshooting/faq/python/\" target=\"_blank\"\u003eFAQ\u003c/a\u003e  •\n  \u003ca href=\"https://alg.li/support\" target=\"_blank\"\u003eSupport\u003c/a\u003e\n\u003c/p\u003e\n\n## ✨ Features\n\n- Thin \u0026 minimal low-level HTTP client to interact with Algolia's API\n- Supports Python from `3.8`\n\n## 💡 Getting Started\n\nFirst, install Algolia Python API Client via the [pip](https://pip.pypa.io/en/stable/installing) package manager:\n\n```bash\npip install --upgrade 'algoliasearch\u003e=4.0,\u003c5.0'\n```\n\nYou can now import the Algolia API client in your project and play with it.\n\n```py\nfrom algoliasearch.search.client import SearchClient\n\n_client = SearchClient(\"YOUR_APP_ID\", \"YOUR_API_KEY\")\n\n# Add a new record to your Algolia index\nresponse = await _client.save_object(\n    index_name=\"\u003cYOUR_INDEX_NAME\u003e\",\n    body={\n        \"objectID\": \"id\",\n        \"test\": \"val\",\n    },\n)\n\n# use the class directly\nprint(response)\n\n# print the JSON response\nprint(response.to_json())\n\n# Poll the task status to know when it has been indexed\nawait client.wait_for_task(index_name=\"\u003cYOUR_INDEX_NAME\u003e\", task_id=response.task_id)\n\n# Fetch search results, with typo tolerance\nresponse = await _client.search(\n    search_method_params={\n        \"requests\": [\n            {\n                \"indexName\": \"\u003cYOUR_INDEX_NAME\u003e\",\n                \"query\": \"\u003cYOUR_QUERY\u003e\",\n                \"hitsPerPage\": 50,\n            },\n        ],\n    },\n)\n\n# use the class directly\nprint(response)\n\n# print the JSON response\nprint(response.to_json())\n```\n\nFor full documentation, visit the **[Algolia Python API Client](https://www.algolia.com/doc/libraries/python/)**.\n\n## ❓ Troubleshooting\n\nEncountering an issue? Before reaching out to support, we recommend heading to our [FAQ](https://www.algolia.com/doc/api-client/troubleshooting/faq/python/) where you will find answers for the most common issues and gotchas with the client. You can also open [a GitHub issue](https://github.com/algolia/api-clients-automation/issues/new?assignees=\u0026labels=\u0026projects=\u0026template=Bug_report.md)\n\n## Contributing\n\nThis repository hosts the code of the generated Algolia API client for Python, if you'd like to contribute, head over to the [main repository](https://github.com/algolia/api-clients-automation). You can also find contributing guides on [our documentation website](https://api-clients-automation.netlify.app/docs/introduction).\n\n## 📄 License\n\nThe Algolia Python API Client is an open-sourced software licensed under the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgolia%2Falgoliasearch-client-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falgolia%2Falgoliasearch-client-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgolia%2Falgoliasearch-client-python/lists"}