Quickstart

Get your API key and make your first request in under a minute.

Quickstart

Get up and running with the Covala API in under a minute.

1. Get an API key

Join the waitlist at covala.com to request early access. We're onboarding developers in batches. Once approved, you'll get an API key instantly — the free tier includes 5,000 requests/month.

2. Make your first request

Search for a product by name:

curl https://api.covala.com/v2/products \
  -H "X-API-Key: YOUR_API_KEY" \
  -G -d "q=ipad air"

Or look up a product by barcode:

curl https://api.covala.com/v2/products/barcode/885909950805 \
  -H "X-API-Key: YOUR_API_KEY"

3. Explore the response

Every product includes structured specs, brand info, categories, and retailer pricing. Single-product responses also include _knowledge metadata showing what intelligence is available:

{
  "data": {
    "name": "Bosch SHPM88Z75N 800 Series Dishwasher",
    "brand": { "name": "Bosch", "slug": "bosch" },
    "_knowledge": {
      "product_type_slug": "dishwashers",
      "available": ["buying_guide", "cost_of_ownership", "error_code", "lifespan", "maintenance_schedule"],
      "entry_count": 24,
      "knowledge_url": "/v2/product-types/dishwashers/knowledge"
    }
  }
}

4. Fetch product knowledge (Starter tier)

With a Starter plan or above, get maintenance schedules, error codes, lifespan data, and more:

curl https://api.covala.com/v2/product-types/dishwashers/knowledge \
  -H "X-API-Key: YOUR_API_KEY"

Or get knowledge inline with a product:

curl "https://api.covala.com/v2/products/{id}?include_knowledge=true" \
  -H "X-API-Key: YOUR_API_KEY"

Next steps

• Authentication — API key details and rate limits
• API Reference — full endpoint reference
• MCP Server — integrate with AI agents
• Join the waitlist — request early access to the API