Contrie API Documentation

Extract structured data from any website using natural language. No CSS selectors, no DOM parsing, no maintenance. Describe what you want and the API handles everything.

Quickstart

Get up and running in 3 steps.

Sign up and get an API key

Try the sample extractions in the playground with no signup. For live extraction, create an account and generate an API key in the dashboard.

Make your first request

curl

curl -X POST https://contrie.com/api/v1/scrape \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ck_live_your_key_here" \
  -d '{
    "url": "https://news.ycombinator.com",
    "extract": "Get the top 5 stories with title, URL, and points"
  }'

Get structured JSON back

Response

{
  "success": true,
  "data": {
    "stories": [
      {
        "rank": 1,
        "title": "Show HN: I built an open-source AI code editor",
        "url": "https://techcrunch.com/2024/01/ai-code-editor",
        "points": 847
      },
      ...
    ]
  },
  "metadata": {
    "url": "https://news.ycombinator.com",
    "extractionMethod": "ai",
    "model": "minimax/minimax-m3:free",
    "qualityScore": 92,
    "grounding": 0.95,
    "escalations": 0,
    "latencyMs": 2340,
    "costUsd": 0,
    "cached": false,
    "credits": 1
  }
}

Base URL

https://contrie.com/api/v1

Endpoints

Method	Endpoint	Description
POST	/api/v1/scrape	Fetch a URL and extract data
POST	/api/v1/extract	Extract data from raw HTML
GET	/api/health	Health check