🏺 Craftia API

About Craftia API

Connect with master craftspeople and traditional techniques from around the world. Discover artisans, workshops, and UNESCO-recognized traditional crafts.

Endpoints

• GET /craftia/api/v1/crafts/search - Search traditional crafts by category, country, or UNESCO heritage status
• GET /craftia/api/v1/crafts/{id} - Get craft details with artisans, techniques, and workshops
• GET /craftia/api/v1/crafts/unesco - Get UNESCO Intangible Cultural Heritage crafts
• GET /craftia/api/v1/artisans/search - Search artisans by commission availability and craft
• GET /craftia/api/v1/artisans/{id} - Get artisan profile with products and contact information
• GET /craftia/api/v1/workshops/search - Search workshops offering classes or tours
• GET /craftia/api/v1/workshops/nearby - Find workshops near a location (geospatial search)

Example Request

curl -H "X-API-Key: sc_live_free_abc123..." \
  "https://socials.ppn-hub.com/craftia/api/v1/crafts/search?category=pottery&unesco=true"

Craft Categories

• pottery - Ceramic and pottery crafts
• textiles - Weaving, dyeing, and fabric crafts
• metalwork - Blacksmithing and metal crafts
• woodwork - Carpentry and wood carving
• paper - Traditional papermaking
• lacquerware - Lacquer application techniques
• jewelry - Traditional jewelry making

Search Parameters

• category - Craft category (pottery, textiles, metalwork, etc.)
• country - Filter by origin country
• region - Filter by specific region
• unesco - Filter UNESCO Intangible Cultural Heritage (true/false)
• craft_id - Filter workshops by specific craft
• offers_classes - Filter workshops offering classes (true/false)
• limit - Results per page (default: 20)
• offset - Pagination offset (default: 0)