Skip to main content
Welcome to the Metorial API! This guide will help you quickly understand how to start using our API and make your first requests.
What you’ll learn:
  • How to use the Metorial API
  • How to get your API key
  • How to make your first API request
Recommended reading:

​
What is the Metorial API?

The Metorial API is a simple, user-friendly way to interact with Metorial’s services. It uses standard web communication (REST) and always returns data in JSON format, making it easy to work with across different programming languages.

​
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_pk_abc123
To get started, let’s make a simple request to fetch a list of threads: 
curl -X GET https://api.metorial.com/secrets \
  -H "Authorization: Bearer metorial_pk_abc123"

​
Client Libraries

We make integration super easy with official SDKs for:

JavaScript

Use Metorial with JavaScript or TypeScript.

Python

Use Metorial with Python.

​
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 pagination. Each response includes 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!

SDK Documentation

Explore SDKs for easier integration.