Post

GET/v1/cosmos/post1 credit

Returns a single Cosmos post: caption, media (images or video), owner, the source it was saved from and its author, and how many times it was saved.

01Query parameters

Name	Type	Description
urlrequired	string	Post URL, e.g. `https://www.cosmos.so/e/2107587668`.

02Request

curl "https://api.scrapesocial.ai/v1/cosmos/post?url=https%3A%2F%2Fwww.cosmos.so%2Fe%2F2107587668" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/cosmos/post?url=https%3A%2F%2Fwww.cosmos.so%2Fe%2F2107587668

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": 2107587668,
  "url": "https://www.cosmos.so/e/2107587668",
  "created_at": "2026-01-24T17:23:49.338775Z",
  "caption": "Japanese movie poster for A Hard Day's Night (1964) featuring The Beatles.",
  "text": null,
  "title": null,
  "description": null,
  "owner": {
    "id": 2074596056,
    "username": "audreyelli"
  },
  "source_url": "https://www.pinterest.com/pin/7177680652369084/",
  "source_author": {
    "username": "telliott1817",
    "full_name": "Tom Elliott",
    "profile_url": "https://www.pinterest.com/telliott1817",
    "avatar_url": null
  },
  "media": [
    {
      "id": "8d612bfd-2b7b-458c-ac99-af7c406eef97",
      "type": "StaticImage",
      "url": "https://cdn.cosmos.so/8d612bfd-2b7b-458c-ac99-af7c406eef97",
      "width": 1080,
      "height": 1671,
      "ai_generated": false,
      "duration": null,
      "thumbnail_url": null,
      "video_url": null,
      "playback_url": null
    }
  ],
  "price": null,
  "brand": null,
  "save_count": 145
}

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

The post fields sit at the top level of the answer; `save_count` is the number of saves. An unknown post, or one that is not public, is a free 404; a URL that is not a Cosmos post 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.