Getting started with the API

Welcome to the Metorial API! This guide will help you quickly understand how to start using our API and make your first requests.

Before you begin: Getting your API key

To use the Metorial API, you'll need an API key. You can generate these in two types:

Publishable API Keys (metorial_pk_):

• Used for public data access
• Safe to use in client-side code
• Starts with metorial_pk_

Secret API Keys (metorial_sk_):

• Provides full project access
• Must be kept private
• Starts with metorial_sk_

Making your first API request

When making a request, you'll always use this base URL:

https://api.metorial.com

To authenticate, include your API key in the request header:

Authorization: Bearer metorial_sk_abc123

Here's a simple request to list your provider deployments:

curl -X GET https://api.metorial.com/provider-deployments \
  -H "Authorization: Bearer metorial_sk_abc123"

{
  "object": "list",
  "data": [
    {
      "object": "provider.deployment",
      "id": "pdp_abc123",
      "status": "active",
      "name": "Exa Search"
    }
  ],
  "has_more_before": false,
  "has_more_after": false
}

Full API reference

You can view the detailed API reference here.

Client libraries

We make integration super easy with official SDKs for:

Important things to know

Rate limits

We have some basic usage limits to keep things fair:

• 1000 requests per IP every 10 seconds
• Development environments: 100 requests per 10 minutes
• Production environments: 5000 requests per 10 minutes

Handling responses

Our API uses standard HTTP response codes:

• 200: Success!
• 400: Something's wrong with your request
• 401: Invalid API key
• 403: Not enough permissions
• 404: Can't find what you're looking for
• 429: You've hit the rate limit

Pagination

When fetching lists of items, we support cursor-based pagination. Each response includes has_more_before, has_more_after, and pagination cursors to help you fetch more items easily.

Need more help?

Check out our full documentation or reach out to our support team. Happy coding!