Developer Resources

API Examples & SDKs

Copy-paste code to start enriching in under a minute.

cURL

curl -X POST https://api.easyenrichment.com/enrich \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "AMZN Mktp US*M12AB3CD4",
    "amount": -49.99
  }'

# Response:
# {
#   "merchant": "Amazon",
#   "category": "Shopping",
#   "logo_url": "https://api.easyenrichment.com/logo/amazon.com",
#   "website": "amazon.com",
#   "mcc_code": "5942",
#   "confidence": 0.97
# }

Reference

All Endpoints

Request bodies and sample responses for every endpoint.

POST/enrich1¢

Transaction Enrichment

Enrich a single transaction description with merchant data.

Request

JSON

{
  "description": "AMZN Mktp US*M12AB3CD4",
  "amount": -49.99
}

Response

JSON

{
  "merchant": "Amazon",
  "category": "Shopping",
  "subcategory": "Online Marketplace",
  "logo_url": "https://api.easyenrichment.com/logo/amazon.com",
  "website": "amazon.com",
  "mcc_code": "5942",
  "confidence": 0.97
}

POST/enrich/batch1¢ each

Batch Enrichment

Enrich up to 100 transactions in a single request.

Request

JSON

{
  "transactions": [
    { "description": "AMZN Mktp US*M12AB3CD4", "amount": -49.99 },
    { "description": "UBER *TRIP 8X4K2", "amount": -23.50 },
    { "description": "SQ *BLUE BOTTLE COFFEE", "amount": -6.25 }
  ]
}

Response

JSON

{
  "results": [
    {
      "merchant": "Amazon",
      "category": "Shopping",
      "logo_url": "https://api.easyenrichment.com/logo/amazon.com",
      "confidence": 0.97
    },
    {
      "merchant": "Uber",
      "category": "Transportation",
      "logo_url": "https://api.easyenrichment.com/logo/uber.com",
      "confidence": 0.95
    },
    {
      "merchant": "Blue Bottle Coffee",
      "category": "Food & Drink",
      "logo_url": "https://api.easyenrichment.com/logo/bluebottlecoffee.com",
      "confidence": 0.93
    }
  ]
}

POST/enrich/company2¢

Company Enrichment

Get detailed company information from a name or domain.

Request

JSON

{
  "name": "Stripe",
  "domain": "stripe.com"
}

Response

JSON

{
  "name": "Stripe",
  "domain": "stripe.com",
  "description": "Financial infrastructure for the internet.",
  "industry": "Financial Technology",
  "employee_count": "5000-10000",
  "founded_year": 2010,
  "hq_location": "San Francisco, CA",
  "logo_url": "https://api.easyenrichment.com/logo/stripe.com"
}

POST/enrich/domain1¢

Domain Enrichment

Look up company info from a domain name.

Request

JSON

{
  "domain": "shopify.com"
}

Response

JSON

{
  "domain": "shopify.com",
  "company_name": "Shopify",
  "industry": "E-commerce Platform",
  "description": "Commerce platform for online and retail stores.",
  "logo_url": "https://api.easyenrichment.com/logo/shopify.com",
  "social_profiles": {
    "twitter": "shopify",
    "linkedin": "shopify"
  }
}

POST/enrich/social1¢

Social Enrichment

Find social media profiles for a company.

Request

JSON

{
  "domain": "notion.so"
}

Response

JSON

{
  "domain": "notion.so",
  "company_name": "Notion",
  "twitter": "NotionHQ",
  "linkedin": "notionhq",
  "facebook": "NotionHQ",
  "instagram": "notionhq",
  "youtube": "NotionHQ"
}

POST/enrich/person2¢

Person Enrichment

Enrich person data from an email address.

Request

JSON

{
  "email": "jane@example.com"
}

Response

JSON

{
  "name": "Jane Smith",
  "title": "VP of Engineering",
  "company": "Example Corp",
  "location": "Austin, TX",
  "linkedin": "janesmith",
  "domain": "example.com"
}

GET/logo/:domainFree

Logo Endpoint

Get a company logo by domain. No authentication required.

Request

HTTP

GET https://api.easyenrichment.com/logo/netflix.com

Response

JSON

// Returns the logo image directly (PNG/SVG)
// Use as an <img> src:
// <img src="https://api.easyenrichment.com/logo/netflix.com" />

// Supports size parameter:
// https://api.easyenrichment.com/logo/netflix.com?size=128

Recipes

Quick Integration Patterns

Common patterns to get you started fast.

Plaid + Easy Enrichment

Enrich Plaid transactions with merchant logos, categories, and more.

Python

plaid_txns = plaid_client.transactions_get(access_token)
for txn in plaid_txns["transactions"]:
    enriched = requests.post("https://api.easyenrichment.com/enrich",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={"description": txn["name"], "amount": txn["amount"]}
    ).json()
    txn["merchant"] = enriched["merchant"]

Batch Processing

Process a CSV of transactions in batches of 100.

Python

import csv, requests

with open("transactions.csv") as f:
    rows = list(csv.DictReader(f))
for i in range(0, len(rows), 100):
    batch = [{"description": r["description"], "amount": float(r["amount"])} for r in rows[i:i+100]]
    results = requests.post("https://api.easyenrichment.com/enrich/batch",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={"transactions": batch}
    ).json()["results"]

React Logo Component

Drop-in component using the free /logo/ endpoint. No API key needed.

React / JSX

function MerchantLogo({ domain, size = 32 }) {
  return (
    <img
      src={`https://api.easyenrichment.com/logo/${domain}?size=${size}`}
      alt={domain}
      width={size}
      height={size}
      style={{ borderRadius: 6 }}
      onError={(e) => { e.currentTarget.style.display = "none"; }}
    />
  );
}

// Usage: <MerchantLogo domain="spotify.com" size={48} />

Get Started

Get Your API Key

20 free API calls. No credit card required.