1. Platforms
  2. Cosmos

Cosmos Scraper API

Pull Cosmos profiles, posts and collections as JSON. Failed requests are free.

100 free credits. No card needed.

Data

What you get from Cosmos.

Profiles

Name, bio, verified status, follower count and post count.

Posts

Text, publish date and saves.

Search

Posts by keyword.

CollectionsTitle, description, owner, item count and cover image.

Uses

What you can build with Cosmos data.

Check accounts

Check an account's followers and recent posts before you reach out.

Track a topic

Search posts by keyword to see what people share about a brand or topic.

Browse collections

Pull collections and what is in them.

Example

Your first request.

  1. Get a keySign up and get 100 free credits. No card needed.
  2. Send a requestPass a handle, URL or keyword with your key.
  3. Use the JSONThe same shape comes back from every platform.
1import os2import requests34params = {5    "handle": "design",6}7res = requests.get(8    "https://api.socialscrape.dev/v1/cosmos/profile",9    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10    params=params,11)12body = res.json()1314if body["ok"]:15    print(body["data"])16else:17    print(body["error"]["code"], body["error"]["message"])
200 OKSample response
{
  "ok": true,
  "credits_charged": 1,
  "credits_remaining": 4999,
  "cached": false,
  "cached_at": null,
  "request_id": "req_0304466741894cf49031423a",
  "data": {
    "object": "profile",
    "platform": "cosmos",
    "id": "234172146",
    "handle": "design",
    "name": "Design",
    "headline": null,
    "url": "https://www.cosmos.so/design",
    "kind": "person",
    "bio": "where systems learn to speak to people",
    "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0",
    "banner_url": null,
    "verified": false,
    "is_private": null,
    "external_url": null
    ...
  },
  "cursor": null,
  "has_more": null
}

Pricing

Pay only for data you get.

  • A profile1 credit
  • A page of posts or search results1 credit
  • A failed requestFree

Starter

$13

1,000 credits

$13.00 per 1,000

Get an API key
Most popular

Growth

$55

25,000 credits

$2.20 per 1,000

Get an API key

Scale

$349

230,000 credits

$1.52 per 1,000

Get an API key

Packs never expire. Monthly plans too. See pricing

Reference

Every Cosmos endpoint

FAQ

Questions

What does the Cosmos API cost?

Most requests cost 1 credit, and transcripts have their own rule; each endpoint page states it. New accounts get 100 free credits. See pricing.

Does it need a Cosmos login?

No. You send your SocialScrape key and never a platform password.

Is it live?

Yes. The endpoints are live: built, tested against recorded responses and watched by canaries. Get an API key.