Two ways to contribute
There are two primary ways to get involved:- Submit a new API or category suggestion — open a GitHub Issue or pull request to propose a new Apify actor or request a new category be added to the directory.
- Run the scraper locally — clone the repository and run the Python scraper yourself to refresh data, test changes, or contribute improvements to the scraper code.
Architecture overview
The pipeline that keeps the directory up to date runs automatically every day:main.pyiterates over all 17 categories defined inApifyScraper.get_category_list().- For each category, it calls Apify’s Algolia search API in batches of 1,000 actors.
- New results are merged with existing JSON data in the
data/directory, preserving historical ratings. - APIs are ranked using a Bayesian scoring algorithm and written back to JSON.
- Per-category
README.mdfiles and the rootREADME.mdare regenerated from the JSON data. - GitHub Actions commits and pushes the updated files on a daily schedule.
Code of conduct
This project welcomes contributors of all backgrounds and experience levels. Please keep discussions respectful and constructive. When in doubt, be kind.GitHub repository
All contributions happen through GitHub: github.com/AgentsAPI/awesome-agent-apisNext steps
Running the scraper
Set up and run the scraper locally to refresh API data.
Adding APIs
Suggest a new API or category for the directory.