Quickstart

This guide will get you all set up and ready to use the Utopian Labs API. We'll cover how to get started using one of our API clients and how to make your first API request. We'll also look at where to go next to find all the information you need to take full advantage of our powerful REST API.

Before you can make requests to the Utopian Labs API, you will need to grab your API key from your dashboard. You find it under Settings » API.

Choose your agent

Before making your first API request, you need to pick which Utopian Labs agent you want to use. We offer several specialized AI agents:

R1 (Research) - Our flagship agent for deep research on companies and people
R1-Qualification - Qualifies leads based on your ideal customer profile
R1-Timing - Determines if this is the right time to contact a lead
R1-Classification - Categorizes leads based on predefined options
R1-Copywriting - Generates personalized sales messages based on research

Each agent comes in two versions: standard and light. Light versions are more affordable but have access to fewer research sources.

Making your first API request

Let's make your first call to the Utopian Labs API using the R1 Research agent. This example shows how to initiate a research run for a specific lead.

POST

/v1/agents/runs

curl -X POST https://api.utopianlabs.ai/v1/agents/runs \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "r1",
    "lead": {
      "company": {
        "website": "example.com",
        "name": "Example Corp"
      },
      "person": {
        "full_name": "John Smith",
        "job_title": "CEO"
      }
    },
    "context": "Looking for potential partnership opportunities"
  }'

The API will respond with a run ID that you can use to check the status of your research:

Response

{
  "id": "abc123"
}

Learn more about the Research agent

What's next?

Great! You've now made your first request to the Utopian Labs API. Here are some helpful resources to explore next: