Komi page

GET/v1/komi1 credit

Returns a public Komi page: the creator's id, username, avatar, bio and names, one field per social profile (`instagram`, `tiktok`, `youtube`, …), website, and every module item of the page as `links` (links, products with price and currency, videos, events, music and podcast links), each with its module `type`.

01Query parameters

Name	Type	Description
urlrequired	string	Komi page URL, e.g. `https://kimkardashian.komi.io/`.
cache_max_ageoptional	string	Accepted for compatibility: how old a cached answer may be. Every call is fetched fresh, so it does not change the answer or the price.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/komi?url=https%3A%2F%2Fkimkardashian.komi.io%2F" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/komi?url=https%3A%2F%2Fkimkardashian.komi.io%2F

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "64d82830-59aa-4488-bfb0-93426971d139",
  "username": "kimkardashian",
  "avatar": "https://komi-production-assets.s3.amazonaws.com/photos/4Nd69ODJHs61_iNYPlqos.jpg",
  "bio": "",
  "firstName": "Kim",
  "lastName": "Kardashian",
  "displayName": "Kim Kardashian",
  "displayNameImage": null,
  "instagram": "https://www.instagram.com/kimkardashian/",
  "tiktok": "https://www.tiktok.com/@kimkardashian",
  "youtube": "https://www.youtube.com/@KUWTK",
  "twitter": "https://twitter.com/KimKardashian",
  "facebook": "https://www.facebook.com/KimKardashian",
  "snapchat": "https://www.snapchat.com/add/kimkardashian?locale=en-GB",
  "website": null,
  "links": [
    {
      "id": "6d7086df-ede4-4f8a-85e5-0fa410e60bc2",
      "url": "https://skims.social/shop-skims",
      "order": 0,
      "title": "Visit SKIMS",
      "visible": true,
      "moduleId": "e6ce39d2-e3df-4040-a5cc-ce016cacbc34",
      "thumbnail": "https://komi-production-assets.s3-accelerate.amazonaws.com/photos/x_LQCBYzoWiel0-yrAnrF.jpg",
      "versionId": "944094bf-f124-4b13-866a-3498c492736d",
      "type": "LINK"
    },
    {
      "id": "f43e198b-2fd5-45f4-80d1-389906c5c840",
      "url": "https://skims.com/products/signature-swim-triangle-bikini-top-dune-crocodile-print",
      "order": 0,
      "price": 44,
      "title": " TRIANGLE BIKINI TOP | DUNE CROCODILE ",
      "visible": false,
      "currency": "USD",
      "moduleId": "5c8bc46c-2d6b-4731-baf3-2f40aec1465c",
      "thumbnail": "https://komi-production-assets.s3-accelerate.amazonaws.com/photos/dzDiYZjZFXPE4E8-ZwnSn.png",
      "versionId": "944094bf-f124-4b13-866a-3498c492736d",
      "type": "PRODUCT"
    }
  ]
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Hidden modules and items are included, as the page's data has them; check `visible`. An unknown page is a free 404; a URL of another site is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.