API Documentation

Everything you need to integrate MetaFetch

Quick Start

1
Sign up for an account
Create your free account to get started with 250 requests/month.
2
Generate an API key
Go to your dashboard and create a new API key.
3
Make your first request
Use the examples below to enrich your first domain.

Authentication

All API requests require authentication using your API key. Include your key in the x-api-key header:

x-api-key: mf_your_api_key

Keep your API keys secure. Never expose them in client-side code or public repositories.

Base URL

https://metafetch-production.up.railway.app

Endpoints

POST/v1/enrich

Enrich a domain with company information. Returns cached data if available, otherwise queues a background job.

Request Body

{
  "domain": "stripe.com"  // Required: The domain to enrich
}

Code Examples

curl -X POST https://metafetch-production.up.railway.app/v1/enrich \
  -H "x-api-key: mf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"domain": "stripe.com"}'

Response Format

Successful responses return a JSON object with the following structure:

{
  "status": "success",
  "data": {
    "domain": "stripe.com",
    "company_name": "Stripe",
    "description": "Online payment processing for internet businesses",
    "logo_url": "https://stripe.com/img/v3/home/twitter.png",
    "favicon_url": "https://stripe.com/favicon.ico",
    "country": "US",
    "city": "San Francisco",
    "industry": "Financial Technology",
    "tags": ["payments", "fintech", "saas", "developer tools"],
    "social_profiles": {
      "linkedin": "https://linkedin.com/company/stripe",
      "twitter": "https://twitter.com/stripe",
      "github": "https://github.com/stripe"
    },
    "last_enriched_at": "2025-12-22T10:30:00Z"
  },
  "cached": true,
  "request_id": "req_abc123"
}

Data Fields

Field	Type	Description
domain	string	The queried domain
company_name	string	Official company name
description	string	Company description/tagline
logo_url	string	URL to company logo
favicon_url	string	URL to site favicon
country	string	Country code (ISO 3166-1)
city	string	City/headquarters location
industry	string	Primary industry classification
tags	array	Related keywords and categories
social_profiles	object	Social media profile URLs
last_enriched_at	datetime	When data was last updated

Rate Limits

Rate limits are applied per API key. Exceeding limits returns a 429 status code.

60/min

Free tier

300/min

Starter tier

1,000/min

Pro tier

Custom

Enterprise

Ready to get started?

Create your free account and start enriching domains today.

Get API Key View Pricing