Collection Posts

GET/v1/cosmos/cluster/posts1 credit

Returns a page of the posts saved in a Cosmos collection, each with caption, media, owner, source and the time it was saved to the collection.

01Query parameters

Name	Type	Description
urlrequired	string	Collection URL, e.g. `https://www.cosmos.so/design/the-best-band-posters`.
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/cluster/posts?url=https%3A%2F%2Fwww.cosmos.so%2Fdesign%2Fthe-best-band-posters" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

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

GET /v1/cosmos/cluster/posts?url=https%3A%2F%2Fwww.cosmos.so%2Fdesign%2Fthe-best-band-posters

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "items": [
    {
      "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,
      "saved_at": "2026-10-03T02:00:48.395167Z"
    },
    {
      "id": 2104791706,
      "url": "https://www.cosmos.so/e/2104791706",
      "created_at": "2024-10-20T12:29:13.9841Z",
      "caption": "The Beatles band poster featuring George Harrison, Paul McCartney, John Lennon, and Ringo Starr.",
      "text": null,
      "title": null,
      "description": null,
      "owner": {
        "id": 633283034,
        "username": "mutlux"
      },
      "source_url": "https://www.etsy.com/listing/1441828075/the-beatles-re-print-vintage-concert",
      "source_author": {
        "username": "etsy",
        "full_name": "Etsy",
        "profile_url": "https://www.pinterest.com/etsy",
        "avatar_url": null
      },
      "media": [
        {
          "id": "a782b9be-96a6-45a4-8c1c-7d06ae6ecbeb",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/a782b9be-96a6-45a4-8c1c-7d06ae6ecbeb",
          "width": 2000,
          "height": 2923,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        }
      ],
      "price": null,
      "brand": null,
      "saved_at": "2026-10-03T02:00:53.711293Z"
    }
  ],
  "total_count": 46,
  "cursor": "eyJ2MSI6MTAuMCwidjIiOjE0NDU4Mzc5fQ==",
  "has_more": true
}

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` (40 per page), each with `saved_at`, next to `total_count`, `cursor` and `has_more`; on the last page `cursor` is null and `has_more` false. An unknown collection is a free 404; a URL that is not a Cosmos collection is a free 400.

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.