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.
- Profiles + collections
- Search by meaning
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
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.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
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.
What Cosmos data can you get?
7 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Profiles
Posts
Collections
Search
Browse all 7 Cosmos endpoints
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.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with Cosmos data
Monitoring, enrichment, research and content workflows on Cosmos data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
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.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- 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.”
“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. 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. Pick the curator, post or collection
Use the username, for example
GET /v1/cosmos/profiles/joris.kahl, or a post or collection link. Sendx-api-keyon every request.3. Branch on the answer
Check
data.lookupStatusbefore you store a row, compare a list with itstotal, and bill frommeta.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