Skip to main content
POST
/
api
/
score
Score a URL
curl --request POST \
  --url https://app.dacard.ai/api/score \
  --header 'Content-Type: application/json' \
  --cookie __session= \
  --data '
{
  "url": "https://linear.app",
  "context": "Linear is a project management tool for software teams"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "url": "<string>",
  "totalScore": 60,
  "stageName": "Legacy",
  "dimensions": [
    {
      "dimensionId": "market_intelligence",
      "dimensionName": "Market Intelligence",
      "score": 2,
      "stageName": "<string>",
      "evidence": "<string>",
      "confidence": "high",
      "reasoning": "<string>"
    }
  ],
  "strengths": [
    "<string>"
  ],
  "gaps": [
    "<string>"
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "companyName": "<string>",
  "crawledPages": [
    "<string>"
  ],
  "crossDimensionNotes": "<string>",
  "antiPatternsDetected": [
    "<string>"
  ],
  "crawlStats": {
    "pagesAnalyzed": 123,
    "contentLength": 123
  },
  "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
__session
string
cookie
required

Clerk session cookie. Authentication is handled by Clerk. Sign in at https://app.dacard.ai/sign-in to obtain a session.

Body

application/json
​
url
string<uri>
required

The product URL to score

Example:

"https://linear.app"

​
context
string

Additional context to improve scoring accuracy

Example:

"Linear is a project management tool for software teams"

Response

Scoring result

​
id
string<uuid>
required

Unique result ID (shareable)

​
url
string<uri>
required

URL that was scored

​
totalScore
integer
required

Sum of all 24 dimension scores

Required range: 24 <= x <= 96
​
stageName
enum<string>
required

Overall maturity tier

Available options:
Legacy,
AI-Curious,
AI-Enhanced,
AI-First,
AI-Native
​
dimensions
object[]
required

All 24 dimension scores

Required array length: 24 elements
​
strengths
string[]
required

Top 3 dimension IDs

Maximum array length: 3
​
gaps
string[]
required

Bottom 3 dimension IDs

Maximum array length: 3
​
createdAt
string<date-time>
required

ISO 8601 timestamp

​
companyName
string

Extracted or user-provided company name

​
crawledPages
string<uri>[]

URLs analyzed during crawl

​
crossDimensionNotes
string | null

LLM narrative on cross-dimension patterns

​
antiPatternsDetected
string[]

Detected anti-pattern names

​
crawlStats
object
​
productId
string<uuid> | null

Associated product ID (if scored within a product context)