List Glyphs

Retrieve a list of glyphs from the marketplace.

Endpoint


GET /glyphs

Authentication

Optional. Some filters may require authentication.

Query Parameters

Parameter	Type	Default	Description
`category`	string	-	Filter by category (launch, secure, optimize)
`type`	string	-	Filter by type (prompt, agent, tool)
`status`	string	published	Filter by status
`verified`	boolean	-	Only verified glyphs
`featured`	boolean	-	Only featured glyphs
`trending`	boolean	-	Only trending glyphs
`ownerId`	string	-	Filter by creator
`search`	string	-	Search in name/description
`limit`	number	20	Results per page (max 100)
`offset`	number	0	Pagination offset

Response

Success (200)


{
  "glyphs": [
    {
      "id": "glyph_abc123",
      "slug": "token-name-generator",
      "name": "AI Token Name Generator",
      "description": "Generate creative token names for your project",
      "type": "prompt",
      "category": "launch",
      "status": "published",
      "verified": true,
      "featured": false,
      "trending": true,
      "coverImage": "https://...",
      "pricing": {
        "model": "per-run",
        "amount": 0.05,
        "currency": "USDC"
      },
      "stats": {
        "totalRuns": 1250,
        "averageRating": 4.8,
        "successRate": 98.5
      },
      "ownerId": "user_xyz",
      "ownerName": "TokenLabs",
      "createdAt": "2024-01-01T00:00:00Z",
      "updatedAt": "2024-01-15T00:00:00Z"
    }
  ],
  "total": 150,
  "limit": 20,
  "offset": 0
}

Response Fields

Field	Type	Description
`glyphs`	array	List of glyph objects
`total`	number	Total matching glyphs
`limit`	number	Results per page
`offset`	number	Current offset

Glyph Object

Field	Type	Description
`id`	string	Unique identifier
`slug`	string	URL-friendly identifier
`name`	string	Display name
`description`	string	Short description
`type`	string	prompt, agent, or tool
`category`	string	launch, secure, or optimize
`status`	string	draft, published, archived
`verified`	boolean	Verification status
`featured`	boolean	Featured status
`trending`	boolean	Trending status
`pricing`	object	Pricing configuration
`stats`	object	Usage statistics
`ownerId`	string	Creator ID
`ownerName`	string	Creator display name

Examples

List All Published Glyphs


curl https://api.glyphrun.com/glyphs

Filter by Category


curl "https://api.glyphrun.com/glyphs?category=launch"

Filter by Type


curl "https://api.glyphrun.com/glyphs?type=prompt"

Search


curl "https://api.glyphrun.com/glyphs?search=token%20generator"

Pagination


curl "https://api.glyphrun.com/glyphs?limit=10&offset=20"

Multiple Filters


curl "https://api.glyphrun.com/glyphs?category=secure&type=agent&verified=true"

Code Examples

JavaScript


const params = new URLSearchParams({
  category: 'launch',
  type: 'prompt',
  limit: '20'
})
 
const response = await fetch(`https://api.glyphrun.com/glyphs?${params}`)
const { glyphs, total } = await response.json()
 
console.log(`Found ${total} glyphs`)
glyphs.forEach(g => console.log(g.name))

Python


import requests
 
response = requests.get(
    'https://api.glyphrun.com/glyphs',
    params={
        'category': 'launch',
        'type': 'prompt',
        'limit': 20
    }
)
 
data = response.json()
print(f"Found {data['total']} glyphs")
for glyph in data['glyphs']:
    print(glyph['name'])

Notes

Public endpoint, no auth required
Results sorted by relevance/trending by default
Maximum 100 results per request
Use pagination for large result sets