Catalog

List services

The catalog for programs, a page at a time in a stable order: every service you can order (it lists more than the website shows, which waits for a review), as slim rows — view=full for whole services. Without parameters: the first 100 and a nextCursor; pass it back as cursor, with the same filters, until it is null. Filters combine; a list parameter takes several values, comma separated. Revalidate with the ETag (If-None-Match → 304).

get/api/v1/services

Request

  • Base URL: https://spoofy.social
  • URL: https://spoofy.social/api/v1/services
  • Auth: none required

Query parameters

platformstring

Platforms, e.g. x, tiktok, telegram — several comma separated (x,tiktok).

metricstring

What grows: followers, likes, views, members, reactions, … (comma separated for several).

targetstring

The kind of link it takes: profile, post, video, channel, group, token, site, …

tierstring

basic, standard or premium.

kindstring

count (units delivered), time (live viewers for a set time) or manual (done for you).

countrystring

Where the accounts are from: a country code (US, BR), a region (EU, ASIA, ARAB, AFRICA, LATAM, EN, US+GB, MULTI), or WW for worldwide only.

qstring

Words; each must start a word of the name, platform, metric, place, tier, tags or description, e.g. real usa. Up to 100 characters.

limitinteger

Services per page: 1–500 (default 100).

cursorstring

Where the page starts: nextCursor of the page before, as it came.

view'slim' | 'full'

slim (default): ServiceRow; full: whole services, as GET /api/v1/services/{id} answers.

Response

One page of the catalog.

totalinteger

How many services match the filters, on every page.

nextCursorstring nullable

Pass it as cursor (with the same filters) for the next page; null on the last one.

Example response

{
  "services": [
    {
      "platform": "x",
      "metric": "followers",
      "tier": "basic",
      "form": [
        {
          "key": "logo"
        }
      ],
      "country": "US"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.