User Posts

GET/v1/cosmos/user/posts1 credit

Returns a page of a user's public Cosmos posts (saved images and videos), each with caption, media, owner, the source it was saved from and its author.

01Query parameters

Name	Type	Description
handlerequired	string	Cosmos username, e.g. `design` (a leading `@` or a profile URL is accepted too).
cursoroptional	string	The `cursor` value of the previous answer, to get the next page. The literal `null` returns an empty end page for free.

02Pricing

1 credit per page. `cursor=null` answers an empty end page (`end_of_pagination: true`) for 0 credits, and an empty page is free too.

03Request

curl "https://api.scrapesocial.ai/v1/cosmos/user/posts?handle=design" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

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

GET /v1/cosmos/user/posts?handle=design

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "items": [
    {
      "id": 1307496415,
      "url": "https://www.cosmos.so/e/1307496415",
      "created_at": "2026-04-01T15:24:45.897845Z",
      "caption": null,
      "text": null,
      "title": null,
      "description": null,
      "owner": {
        "id": 14413015,
        "username": "esther.yang"
      },
      "source_url": null,
      "source_author": null,
      "media": [
        {
          "id": "34647529-5d71-4c17-83c1-876e5500317c",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/34647529-5d71-4c17-83c1-876e5500317c",
          "width": 1440,
          "height": 1920,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        }
      ],
      "price": null,
      "brand": null
    },
    {
      "id": 231368414,
      "url": "https://www.cosmos.so/e/231368414",
      "created_at": "2026-07-22T04:24:41.491306Z",
      "caption": "Ad for Halston colognes with bottles designed by Elsa Peretti.",
      "text": null,
      "title": null,
      "description": null,
      "owner": {
        "id": 234172146,
        "username": "design"
      },
      "source_url": "https://www.pinterest.com/pin/65443000829576944/",
      "source_author": null,
      "media": [
        {
          "id": "1d0d58e8-19b8-4ebf-b773-dc7da702df1e",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/1d0d58e8-19b8-4ebf-b773-dc7da702df1e",
          "width": 564,
          "height": 799,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        }
      ],
      "price": null,
      "brand": null
    }
  ],
  "total_count": 25,
  "cursor": null,
  "has_more": false
}

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"
}

05Notes

Posts are in `items` (up to 40 per page), with `total_count`, `cursor` and `has_more`; on the last page `cursor` is null and `has_more` false. `caption` is an automatically written description of the image. An unknown user is a free 404.

06Errors & 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.