{"id":26103316,"url":"https://github.com/constructor-io/constructorio-python","last_synced_at":"2025-06-13T21:38:53.761Z","repository":{"id":37587710,"uuid":"42961184","full_name":"Constructor-io/constructorio-python","owner":"Constructor-io","description":"Python client for the Constructor.io API","archived":false,"fork":false,"pushed_at":"2025-01-13T19:04:08.000Z","size":4275,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":35,"default_branch":"master","last_synced_at":"2025-06-05T13:05:41.864Z","etag":null,"topics":["autocomplete","constructorio","constructorio-integrations","http","python","rest-client","search"],"latest_commit_sha":null,"homepage":"","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/Constructor-io.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,"zenodo":null}},"created_at":"2015-09-22T21:14:22.000Z","updated_at":"2025-01-13T19:04:10.000Z","dependencies_parsed_at":"2023-01-25T13:45:32.338Z","dependency_job_id":"ca70cd34-d4c9-4d46-837e-fb324a68e52b","html_url":"https://github.com/Constructor-io/constructorio-python","commit_stats":null,"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/Constructor-io/constructorio-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Constructor-io%2Fconstructorio-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Constructor-io%2Fconstructorio-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Constructor-io%2Fconstructorio-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Constructor-io%2Fconstructorio-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Constructor-io","download_url":"https://codeload.github.com/Constructor-io/constructorio-python/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Constructor-io%2Fconstructorio-python/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259724468,"owners_count":22902097,"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":["autocomplete","constructorio","constructorio-integrations","http","python","rest-client","search"],"created_at":"2025-03-09T20:06:21.828Z","updated_at":"2025-06-13T21:38:53.717Z","avatar_url":"https://github.com/Constructor-io.png","language":"Python","readme":"# Constructor.io Python Client\n\n[![Version](https://img.shields.io/pypi/v/constructor-io.svg)](https://pypi.python.org/pypi/constructor-io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\nA Python client for [Constructor.io](http://constructor.io/). [Constructor.io](http://constructor.io/) provides search as a service that optimizes results using artificial intelligence (including natural language processing, re-ranking to optimize for conversions, and user personalization).\n\n## Documentation\nFull API documentation is available on [Github Pages](https://constructor-io.github.io/constructorio-python)\n\n## Requirements\n\nRequesting results from your back-end can be useful in order to control result rendering logic on your server, or augment/hydrate results with data from another system. However, a back-end integration has additional requirements compared to a front-end integration. Please review the [Additional Information For Backend Integrations](https://github.com/Constructor-io/constructorio-python/wiki/Additional-Information-for-Backend-Integrations) article within the wiki for more detail.\n\n## 1. Install\n\n```\npip install constructor-io\n```\n\n## 2. Retrieve an API key and token\n\nYou can find this in your [Constructor.io dashboard](https://constructor.io/dashboard). Contact sales if you'd like to sign up, or support if you believe your company already has an account.\n\n## 3. Implement the Client\n\nOnce imported, an instance of the client can be created as follows:\n\n```python\nfrom constructor_io.constructor_io import ConstructorIO\n\nconstructorio = ConstructorIO({\n    \"api_key\": \"YOUR API KEY\",\n})\n```\n\n## 4. Retrieve Results\n\nAfter instantiating an instance of the client, four modules will be exposed as properties to help retrieve data from Constructor.io: `search`, `browse`, `autocomplete`, and `recommendations`.\n\n## Development\n\n```bash\nmake install                            # install dependencies\npipenv run pylint constructor_io  # run lint\npipenv run pytest .                     # run tests with coverage report\nmake docs                               # output documentation to `./docs` directory\n```\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconstructor-io%2Fconstructorio-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconstructor-io%2Fconstructorio-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconstructor-io%2Fconstructorio-python/lists"}