All platforms7 Cosmos endpoints

Cosmos API. Curators, collections and saves as JSON.

Look up a Cosmos curator, read their latest saves and collections, open any post or collection, and search images by describing them.

No credit card requiredRead the API docs
  • Profiles + collections
  • Search by meaning
  • 1 credit per request
  • Failed requests aren't charged
99.8% uptime#3 Product of the Day3,200+ developers

Teams running monitoring, research, and enrichment pipelines

Cosmos data as JSON. You build the product.

Live Cosmos data in one response shape, with platform changes handled for you.

Cosmos, plus every other platform

One key and one response envelope for Cosmos and 86 more platforms.

  • API key

    sk_live_••••••••

Pricing you can reason about

One request, one credit. Know how far your balance will go before you run your next batch.

Requests
480
Credits
480

Balance

Live data on every request

Fetch public data when you ask for it.

Just now1h ago

Nothing to maintain

We handle platform changes and breakages.

Built for production jobs

Run concurrent workloads with explicit statuses and request IDs.

req_8f42200
req_a91c200
req_3e07200
req_d5b8200

lookupStatus: found

Regular jobs. Better rates.

Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.

MonthlyLower rate
Pay as you go

Example request

GET /v1/cosmos/profiles/{handle}. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON
Use cases

What teams build with Cosmos data

Monitoring, enrichment, research and content workflows on Cosmos data, on the same API as every other platform.

Find curators

Check followers, collections and what they save.

Follow collections

Track what is added to a collection.

How it works

Your first request in three steps.

Use TypeScript or your automation tool of choice.

  1. API key

    sfk_live_••••••••••••

    Free requests100

    Step 1: Create your free account

    Get an API key with 100 requests included.

  2. GET/v2/instagram/profiles/charlidamelio

    1 request · 1 credit

    Step 2: Choose an endpoint

    Pass a username, URL, keyword, or post ID.

  3. 200 OK1.82s

    {

    "handle": "charlidamelio",

    "displayName": "Charli D'Amelio",

    "followers": 48300000,

    "following": 1284

    }

    Step 3: Get clean JSON

    Use the response immediately or send it into your pipeline.

Works with your stack

Code, automate, or connect your AI.

Explore integrations

Pricing

Social data, priced simply.

Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.

Starter

$29.00

18,000credits

  • Top up from $1.61 / 1k if you run out
  • Up to 25 monitors
Most popular

Growth

$79.00

50,000credits

  • Top up from $1.58 / 1k if you run out
  • 5 team seats
  • Up to 100 monitors

Scale

$225.00

150,000credits

  • Top up from $1.50 / 1k if you run out
  • 25 team seats
  • Up to 250 monitors
  • Cancel anytime
  • 30-day money-back guarantee
  • Price locked while you stay

Need 1M+ credits, invoicing, or volume rates? Talk to us

Trust signals

DevHunt

Product Hunt

Uneed

Customers

Teams building on Social Fetch.

“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”

Daniel Reeve · Founder, Social Crow
  • “A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”

    Jade P. · Founder, inko
  • “Live profile data on every request. We never flag accounts from a stale cache.”

    Hannah Webb · Founder, Scam Finder
  • “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”

    Owen Pritchard · Founder, IP Flare

Cosmos API: common questions

What Cosmos data can I get from the API?

Curator profiles, their latest posts and public collections, single posts and collections, the latest posts of a collection, and post search.

How do I name a Cosmos curator?

Use the username from the profile link, cosmos.so/{username}, for example joris.kahl. An unknown username returns lookupStatus: not_found.

Can I page through all of a curator's posts?

Not yet. Without signing in Cosmos shows the latest page of each list, so the lists return that page and a total of how many exist.

What is a collection?

A board a curator saves posts into, sometimes with collaborators and sub-collections. Its link is cosmos.so/{username}/{collection}.

How does search work?

Cosmos searches by meaning: describe what you want, in any language, and it returns the closest posts, about 40 a request.

Do you return the images themselves?

No. Each post links to its image or video file and to the source it was saved from; download the file if you need it.

How much does the Cosmos API cost?

Every Cosmos route charges a flat amount per completed request, shown on each endpoint page. A found or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

The Cosmos API in detailHow the Cosmos routes work, what they cost, and how they differ from the official API.

Why teams use Social Fetch for Cosmos

GET /v1/cosmos/profiles/{handle} returns a Cosmos curator: name, bio, avatar, website, social links, membership, verification and counts of posts, collections, followers and following. /posts and /collections under it list the latest saves and the public collections.

A post (GET /v1/cosmos/posts?url=) carries its image or video with its size, the caption Cosmos wrote, when it was saved, who saved it and where it came from. A collection (GET /v1/cosmos/collections?url=) carries its owner, cover, size and followers, and /collections/posts lists what is in it. Search finds posts by meaning, in any language. Every answer is JSON in the { data, meta } envelope with data.lookupStatus; lists carry total. A miss comes back as lookupStatus: not_found, not as an HTTP error.

How to call the Cosmos API

  1. 1. Create an API key

    Sign up at Social Fetch and copy a key (sfk_…). New accounts get 100 free credits, enough to try every route on a few curators.

  2. 2. Pick the curator, post or collection

    Use the username, for example GET /v1/cosmos/profiles/joris.kahl, or a post or collection link. Send x-api-key on every request.

  3. 3. Branch on the answer

    Check data.lookupStatus before you store a row, compare a list with its total, and bill from meta.creditsCharged.

What each Cosmos route returns

  • Curator profile with bio, website, social links, membership and counts.
  • A curator's latest posts and public collections, with totals.
  • Single posts with media, caption, saver and source.
  • Single collections with owner, cover, size and followers, and their latest posts.
  • Post search by meaning, in any language.

How much does the Cosmos API cost?

Each Cosmos route charges a flat credit amount per completed request, shown on every endpoint page. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.

Social Fetch vs the official Cosmos API

Social Fetch gives every Cosmos route one JSON shape: ISO 8601 UTC timestamps, numeric counts, ids as strings, absolute links and typed lookupStatus responses. You do not need a Cosmos account, an app registration or a user session.

Pull your first Cosmos data.

Run a live Cosmos request in the playground. 100 free credits, no card, JSON back in seconds.

No credit cardSign up in 30 seconds withGoogleGitHub