Cubify
Back to AI instructions

Cubify8 / Head-to-head analysis

Compare API

Compare two official profiles event by event without inventing a winner where data is missing.

POST/api/v1/comparisonsLive

Why use this API?

Use Compare to see which competitor has the stronger official world ranking across shared events, and where the available evidence is incomplete.

Request example

What to send

request.httphttp
POST /api/v1/comparisons
Content-Type: application/json

{
  "wcaIdA": "2022RPRA01",
  "wcaIdB": "2017BACH09"
}

Response example

What comes back

response.jsonjson
{
  "data": {
    "competitors": { "a": { "wcaId": "2022RPRA01" }, "b": { "wcaId": "2017BACH09" } },
    "events": [{ "eventId": "333", "shared": true, "slots": [] }],
    "score": { "sharedEvents": { "a": 4, "b": 2 } }
  },
  "source": "World Cube Association"
}

Practical use

When it helps

  • Help a cuber understand a likely rival’s strengths event by event.
  • Generate evidence-led head-to-head context for an AI conversation.
  • Compare progress with a training partner using official ranking data.

Data notes

Use it responsibly

  • A lower world rank is stronger.
  • Only available official records participate in a result.
  • A missing record is not treated as a poor result.