Browse approved apps and skills from the public Grid and skill registry.
These endpoints power Apps and the skill registry. They return store listings (metadata, category, rank, tags) — not full app manifests or skill instructions.
No API key is required. Send X-API-Version: 2 for bare JSON responses (recommended). See REST overview — API version.
→ Search API — semantic discovery across apps, skills, and knowledge
→ Skills API — skill content, versions, and management
→ Apps API — your team's apps and deploy workflows
List approved apps
GET /store/apps or POST /store/apps/list
Returns apps with an approved store version, sorted by rank (descending) when you omit sort.
Query parameters (GET)
| Parameter | Description |
|---|---|
cursor | Pagination cursor |
limit | Page size (default 10) |
direction | forward or backward (default forward) |
filters | JSON array of { "field", "value", "operator" } filters |
sort | JSON array of { "field", "dir" } sort orders |
search | JSON object { "term", "fields", "exact" } for text search (term is the query string) |
POST accepts the same fields in the JSON body.
Response (PublicAppStoreDTO)
| Field | Description |
|---|---|
id | App / listing ID (same as app ID) |
namespace, name | App ref (namespace/name) |
description | Short description |
category, subcategory | Grid grouping |
tags | Store tags |
images | App card images |
is_featured | Featured in the Grid |
rank | Sort rank (higher = more prominent) |
has_approved_version | Always true for this endpoint |
page_id | Optional docs page link |
1curl "https://api.inference.sh/store/apps?limit=20" \2 -H "X-API-Version: 2"1curl -X POST https://api.inference.sh/store/apps/list \2 -H "Content-Type: application/json" \3 -H "X-API-Version: 2" \4 -d '{"limit": 20, "search": {"term": "whisper", "fields": ["name", "description"]}}'Pagination matches other cursor list endpoints (items, next_cursor, has_next, total_items, …).
Get app store listing
GET /store/apps/{appId}
Returns store metadata for one approved app (AppStoreListingDTO), including installs, worker restrictions, and concurrency limits. Use this when you already have an app ID from a list response.
1curl "https://api.inference.sh/store/apps/app_abc123" \2 -H "X-API-Version: 2"Get app pricing
GET /store/apps/{appId}/pricing
Returns the published pricing config for the app's current store version (AppPricing — CEL expressions, price variables, rendered description). Used by public app pages.
1curl "https://api.inference.sh/store/apps/app_abc123/pricing" \2 -H "X-API-Version: 2"→ Usage-based pricing · Get task cost
List approved skills
GET /store/skills or POST /store/skills/list
Returns skills with an approved store listing. Same cursor, filter, sort, and search parameters as List approved apps.
Response (PublicSkillStoreDTO)
| Field | Description |
|---|---|
id | Skill / listing ID |
namespace, name | Skill ref (namespace/name) |
description | Short description |
category | Registry grouping |
tags | Store tags |
is_featured | Featured in the registry |
rank | Sort rank |
has_approved_version | Always true for this endpoint |
1curl "https://api.inference.sh/store/skills?limit=20&filters=%5B%7B%22field%22%3A%22namespace%22%2C%22value%22%3A%22inferencesh%22%2C%22operator%22%3A%22eq%22%7D%5D" \2 -H "X-API-Version: 2"Example filters value (URL-encoded above):
1[{"field": "namespace", "value": "inferencesh", "operator": "eq"}]Get skill store listing
GET /store/skills/{skillId}
Returns store metadata for one skill (SkillStoreListingDTO), including installs and uses counts.
1curl "https://api.inference.sh/store/skills/skill_abc123" \2 -H "X-API-Version: 2"To fetch skill content (instructions and files), use Skills API (GET /skills/{namespace}/{name}/content).
Store vs search vs resource APIs
| Need | Endpoint |
|---|---|
| Browse approved Grid apps with category/rank | GET /store/apps |
| Browse approved registry skills | GET /store/skills |
| Autocomplete / unified discovery | GET /suggest |
| Full-text search with scores | GET /search |
| Run an app | POST /run (Tasks) |
| Read skill instructions | GET /skills/{namespace}/{name}/content |
| Manage your team's apps or skills | Apps / Skills (authenticated) |
Related
| Guide | Topic |
|---|---|
| Browsing the Grid | Workspace app discovery |
| Skill registry | Workspace skill discovery |
| Search concept | Suggest vs search |