Docs

API Reference

Complete reference for the LarryBrain skill marketplace API.

Base URL

https://www.larrybrain.com/api

Auth header

x-api-key (NOT Bearer)

Rate limit

60 requests / minute

AuthenticationUse the x-api-key header. not Authorization: Bearer. Free skills and search endpoints work without any authentication.

Endpoints

GET/api/skills/searchPublic. No auth

Search the skill marketplace. No authentication required. All skills are browsable.

Parameters

qstringrequiredSearch query

limitnumberResults to return (1–50, default 10)

categorystringFilter by category slug

sortstringSort order: popular | rating | newest

Example

curl "https://www.larrybrain.com/api/skills/search?q=marketing&limit=10"

Response

{
  "skills": [
    {
      "slug": "larry-marketing",
      "name": "Larry Marketing",
      "description": "Autonomous TikTok and Instagram marketing automation",
      "category": "marketing",
      "free": true,
      "rating": 4.8,
      "installs": 1240
    }
  ],
  "total": 1
}

GET/api/skills/installx-api-key (optional)

Download a skill's files. Free skills work without authentication. Premium skills require an x-api-key header.

Parameters

slugstringrequiredSkill identifier (e.g. adblock-dns)

modestringrequiredMust be: files

vstringYour current LarryBrain skill version (for update checks)

Example

# Free skill (no auth needed)
curl "https://www.larrybrain.com/api/skills/install?slug=xcellent&mode=files"

# Premium skill (include API key)
curl -H "x-api-key: $LARRYBRAIN_API_KEY" \
  "https://www.larrybrain.com/api/skills/install?slug=adblock-dns&mode=files"

Response

{
  "skill": {
    "slug": "adblock-dns",
    "name": "AdBlock DNS",
    "version": "2.1.0"
  },
  "files": [
    {
      "path": "SKILL.md",
      "content": "---\nname: adblock-dns\n..."
    },
    {
      "path": "scripts/setup.sh",
      "content": "#!/bin/bash\n..."
    }
  ]
}

GET/api/skills/trendingPublic. No auth

Get the most-installed skills over a given time period.

Parameters

periodstringTime range: week | month (default: week)

limitnumberResults to return (default 10)

Example

curl "https://www.larrybrain.com/api/skills/trending?period=week&limit=10"

GET/api/skills/accessx-api-key required

Check whether your API key has access to a specific skill. Useful before attempting an install.

Parameters

skillstringrequiredSkill slug to check access for

Example

curl -H "x-api-key: $LARRYBRAIN_API_KEY" \
  "https://www.larrybrain.com/api/skills/access?skill=adblock-dns"

Response

{
  "access": true,
  "reason": "active_subscription"
}

Error Codes

Code	Meaning
`200`	Success
`400`	Bad request. Missing or invalid parameters.
`401`	Invalid or missing API key
`403`	Subscription required. Skill is premium.
`404`	Skill not found
`429`	Rate limited. Max 60 req/min.
`503`	Service temporarily unavailable

Publishing Skills