Skip to content
Taguten

Quick Start

This guide will help you set up Taguten and make your first API call.

Prerequisites

Before you begin, you’ll need:

  • A Taguten account (sign up at taguten.com)
  • An API key from your dashboard

Step 1: Create an Application

Applications are containers for your tags and items. Each application has its own set of tags, categories, and implications.

  1. Log in to your Taguten dashboard
  2. Click “Create Application”
  3. Give your application a name (e.g., “My Art Gallery”)

Step 2: Get Your API Key

  1. In your application settings, navigate to “API Keys”
  2. Click “Create API Key”
  3. Copy your API key - you won’t be able to see it again!

Step 3: Create Your First Item

Create an item and tag it in a single API call. Tags are automatically created if they don’t already exist.

Terminal window
curl -X POST https://api.taguten.com/v1/applications/{app_id}/items \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_url": "https://example.com/artwork/001",
    "tags": ["fox", "forest"]
  }'

The external_url field is how you reference your own content - typically a URL to the resource you’re tagging.

Step 4: Search by Tags

Find items that match specific tags:

Terminal window
# Find items with both "fox" AND "forest" tags
curl "https://api.taguten.com/v1/applications/{app_id}/items?tags=fox&tags=forest" \
  -H "Authorization: Bearer YOUR_API_KEY"


# Find items with "animal" but NOT "dog"
curl "https://api.taguten.com/v1/applications/{app_id}/items?tags=animal&tags=-dog" \
  -H "Authorization: Bearer YOUR_API_KEY"

What’s Next?