API Overview
REST API
The AiNouns API lets you integrate the marketplace into your own tools and workflows.
Base URL: https://api.ainouns.com/v1
Authentication: API key via Authorization: Bearer <key> header
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /skills | List all skills |
| GET | /skills/:id | Get skill details |
| GET | /skills/:id/skill.md | Fetch the SKILL.md file |
| GET | /categories | List categories |
| POST | /skills | Submit a new skill (auth required) |
| GET | /users/:id/installs | List user's installed skills |
Example request
curl https://api.ainouns.com/v1/skills/instagram-content \
-H "Authorization: Bearer YOUR_API_KEY"Rate limits
- Unauthenticated: 60 requests/hour
- Authenticated: 1,000 requests/hour
- Skill fetch (skill.md): 10,000 requests/hour (CDN-backed)
SDKs
JavaScript and Python SDKs are in development. Follow the changelog for updates.