{"id":19190774,"url":"https://github.com/rtlee9/comparatory-api","last_synced_at":"2025-09-23T04:20:12.098Z","repository":{"id":93162460,"uuid":"117949660","full_name":"rtlee9/comparatory-api","owner":"rtlee9","description":"API for commercial intelligence","archived":false,"fork":false,"pushed_at":"2018-01-18T07:46:43.000Z","size":74080,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-04T06:43:27.105Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rtlee9.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-01-18T07:43:00.000Z","updated_at":"2018-02-01T18:07:34.000Z","dependencies_parsed_at":"2023-06-05T07:30:37.676Z","dependency_job_id":null,"html_url":"https://github.com/rtlee9/comparatory-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rtlee9%2Fcomparatory-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rtlee9%2Fcomparatory-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rtlee9%2Fcomparatory-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rtlee9%2Fcomparatory-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rtlee9","download_url":"https://codeload.github.com/rtlee9/comparatory-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240266875,"owners_count":19774081,"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-09T11:35:43.689Z","updated_at":"2025-09-23T04:20:07.030Z","avatar_url":"https://github.com/rtlee9.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Comparatory\n## Commercial intelligence API\n\n[Comparatory](https://comparatory.io/) is a web application that provides novel insights about public companies based on free text data from regulatory filings. It uses deep learning to understand a company's business model, and provides several channels to explore the competitive landscape.\n\nStart using the Comparatory [web application](https://comparatory.io/) for free today, or host this open source Comparatory API following the usage instructions below. API specifications can be found in `api.raml` (rendered into interactive HTML [here](https://comparatory.io/api-about)).\n\n## Usage (Python 2.7)\n1. Set environment variables:\n\t* `CONFIG`: configuration type (`config.ProductionConfig`, `config.DevelopmentConfig`)\n\t* `ES_HOST=`:  URL of ElasticSearch server\n\t* `AWS_ACCESS_KEY_ID`:  AWS ID for downloading pretrained model\n\t* `AWS_SECRET_ACCESS_KEY`:  AWS key for downloading pretrained model\n1. Initialize ElasticSearch (one time) with company descriptions: `python index_descriptions.py`\n1. Set up virtualenv: `virtualenv venv \u0026\u0026 source venv/bin/activate`\n1. Install requirements: `pip install -r requirements.txt`\n1. Run web application: `python run.py` or `gunicorn app:app`\n1. Profit: `curl -G -XGET 'localhost:5000/companies/describe' --data-urlencode 'description=commercial insurance brokerage'`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frtlee9%2Fcomparatory-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frtlee9%2Fcomparatory-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frtlee9%2Fcomparatory-api/lists"}