Search APIs
Loading…
← API Store
Social

Cosmos

Cosmos API for profiles, collections, saved elements and search on the visual discovery app, as JSON.

Operation
7 operations
Response format
REST / JSON
Per call
1 credit
Pricing

20 free credits on sign-up

Top-ups from 2 USDT per 1,000 credits. Most endpoints cost 1 credit per call; failed calls are free.

Endpoint prices →

Overview

Cosmos API for profiles, collections, saved elements and search on the visual discovery app, as JSON.

Every Cosmos endpoint returns live data. Pick an endpoint on the left to see parameters, code and a sample response, and run a test call.

What you can build with Cosmos

Visual trend research — Search Cosmos for a style or theme and collect the elements people save to spot visual trends.

Mood board export — Pull every element in a collection, with media and source links, to reuse a mood board elsewhere.

Creator and curator discovery — Look up a profile and its collections to find designers and curators to work with.

Image source tracking — Read an element's source URL and author to credit or trace where a saved image came from.

Questions about Cosmos

Which operations does Cosmos provide?

This product provides 7 operations. The documentation above lists parameters, default requests and example responses. Check that the structure meets your needs before integrating.

How do I make my first request?

Sign up, create an API key in the console and get 20 free credits. Try any endpoint in the playground, then copy the code sample.

Is the data live?

Yes. Each call fetches from the source and returns the result; add fresh=1 to skip the 24-hour cache.

How are credits charged?

Each endpoint shows its credits per call; most cost 1. Successful calls, and lookups that ran but found nothing (404), are charged; invalid input, errors on our side and timeouts are free. All keys share one balance.

How do I top up?

Top up with USDT (TRC-20), minimum 5 USDT. Three tiers by the size of one top-up: under 100 → 3 USDT per 1,000 credits, 100–200 → 2.5 USDT, 200 and more → 2 USDT. Pick an amount on the console billing page and contact us; credits are added once the transfer arrives and never expire.

What should I do after a request times out?

First look up the original result with GET /v1/requests/:id using its request_id. Only send a new call once the original has failed, so you are not charged twice.