public-api-finder
v0.3.3
Published
Find free/public APIs for agents and prototypes.
Maintainers
Readme
Public API Finder
Find free/public APIs for agents, prototypes, demos, and integrations.
Powered by multiple sources plus a curated best-known API layer:
public-api-lists/public-api-listsfor fast curated JSON discoverypublic-apis/public-apisfor the larger canonical README listAPIs-guru/openapi-directoryfor OpenAPI-backed APIs
Quick start
npx --yes --package=public-api-finder -- public-api-finder "weather forecast" --no-auth --https
npx --yes --package=public-api-finder -- public-api-finder "crypto prices" --category Cryptocurrency --limit 5
npx --yes --package=public-api-finder -- public-api-finder "jobs" --json
npx --yes --package=public-api-finder -- public-api-finder "payments" --openapiWhy
Agents often waste time wandering the web for APIs. This gives them a small, predictable first stop: search a curated list, filter by auth/HTTPS/CORS, then verify the chosen API docs before coding.
Fits in the Echo agent toolchain
Use public-api-finder when an agent needs a data source for a prototype, bot, dashboard, or demo. It narrows the search space quickly, then the agent should still live-check the selected API docs before writing integration code.
This is the discovery layer for Echo builds that need outside data without starting from a blind web search.
Refresh smoke
npm test
npm pack --dry-run --jsonSkill
The package includes an agent skill at:
skills/public-api-finder/SKILL.mdThe skill tells agents to prefer the CLI first, then live-check docs/endpoints before building.
CLI options
--category <name> Filter by category substring
--source <name> Filter by source: public-api-lists, public-apis, apis-guru, curated
--no-auth Only APIs with Auth = No
--https Only HTTPS APIs
--cors <value> Filter by CORS: Yes, No, Unknown
--openapi Only APIs with OpenAPI specs
--limit <n> Max results
--json Emit JSON
--refresh Refresh cacheRelease Automation
This package is published from GitHub Actions using npm Trusted Publishing with provenance. Releases are built on GitHub-hosted runners and no long-lived npm publish token is required.
