Accounts

What a check can answer, per platform

GET/data-api/v2/accounts/platforms
Scope
directory:read
Freshness
catalog read
Group
Accounts
Platforms
any

What this endpoint answers

The capability map for the account surface: for each of the seven platforms, whether a catalog check is available, which backend the live check reads, how many live reads per minute that source allows across all callers, and whether ownership can be proved with a bio code. Read this once before you integrate - it is static, free, and it tells you which fields will be null on which platform before you discover it in production.

This is a catalog read: it is served from the CRM Solid database in milliseconds, costs one budget unit, and reports how old the reading is in meta.cache_age_s. It needs the directory:read scope (Directory): Read the account and channel catalog across all seven platforms.

Good to know

  • precision: rounded means the platform rounds before we ever see the number. YouTube has done this to subscriber counts since 2019, so a channel on 1,243,912 reports 1.24M and no amount of polling recovers the rest.
  • catalog.available is false only for LinkedIn, and that is a policy decision rather than a coverage gap: we hold LinkedIn company data under the leads:read scope for our own outreach and do not republish it cheaply. The live check still covers LinkedIn.
  • live.reads_per_minute is a ceiling on the SOURCE, shared across every caller, not a per-key limit. It is null on X and Instagram, where the lookup service in front of the source runs its own concurrency control and your tier's live limit is the only ceiling you will meet. It is a real number on the five platforms we scrape directly, and it is four a minute on LinkedIn because company pages are heavy and LinkedIn blocks anything that reads them faster.
  • ownership_verification is offered on six of the seven. LinkedIn is the exception, and it is the source rather than the feature: a company page carries no owner-editable text we can read logged out, so there is nothing for a code to live in. It is not offered-but-broken anywhere.

Parameters

This endpoint takes no path or query parameters.

Call it

Authenticate with a bearer token or the x-api-key header. Keys are server-to-server credentials. Never embed one in front-end code - call the API from your own backend and forward the result.

curl
curl "https://crmsolid.com/data-api/v2/accounts/platforms" \
  -H "Authorization: Bearer psk_live_..."
JavaScript
const res = await fetch("https://crmsolid.com/data-api/v2/accounts/platforms", {
  headers: {
    Authorization: `Bearer ${process.env.CRM_SOLID_DATA_API_KEY}`,
  },
});

if (!res.ok) {
  const { error } = await res.json();
  throw new Error(`${error.code}: ${error.message} (${error.request_id})`);
}

const { data, meta } = await res.json();
Python
import os

import requests

res = requests.get(
    "https://crmsolid.com/data-api/v2/accounts/platforms",
    headers={"Authorization": f"Bearer {os.environ['CRM_SOLID_DATA_API_KEY']}"},
    timeout=30,
)
res.raise_for_status()

payload = res.json()
data, meta = payload["data"], payload["meta"]

Keys look like psk_live_... for production keys, psk_test_... for test keys and are minted in the panel.

What comes back

Success is { data, meta }. Failure is { error: { code, message, request_id } }. The body below is the spec's own example: the values in it are illustrative readings, not live numbers.

Platforms
1 items
200 GET /accounts/platforms
{
  "data": {
    "platforms": [
      {
        "platform": "x",
        "label": "X",
        "object": "account",
        "audience_metric": "followers",
        "precision": "exact",
        "catalog": {
          "available": true,
          "note": null,
          "fields": [
            "created_at",
            "citation_score",
            "country"
          ],
          "directory_path": "/best-x-accounts"
        },
        "live": {
          "available": true,
          "source": "live:xlookup",
          "reads_per_minute": null,
          "note": "Read live from our own X scraper. Exact follower count, no rounding."
        },
        "ownership_verification": {
          "available": true,
          "field": "bio",
          "endpoint": "/scrape/x/verify"
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_9f2c41a8b3d5",
    "generated_at": "2026-08-23T09:14:02.317Z",
    "took_ms": 42
  }
}

The meta block

  • request_idstringrequired

    Unique id for this request. Quote it in a support ticket.

  • generated_atstringrequired

    Server time the response was produced.

  • took_msintegerrequired

    Milliseconds spent server-side.

  • pagePageoptional
  • sourcestringoptional

    Which backend served the payload, for endpoints with more than one.

  • cache_age_sintegeroptional

    Age of the underlying data in seconds. 0 for live reads.

When it fails

GET /accounts/platforms documents 7 failure statuses. Branch on error.code, which is stable and enumerated; message is prose and may change.

  • 401Unauthorizedunauthorized | invalid_key

    No key was presented, or the key is unknown, revoked or expired.

  • 402PaymentRequiredpayment_required | subscription_inactive

    The key is valid but the plan behind it cannot serve the call: the included requests are spent and overage is switched off, capped or unfunded (payment_required), or the billing period lapsed and was not renewed (subscription_inactive). Retrying does not help; paying does. The X-Plan-* headers on this response say how far past the line you are.

    Carries X-Plan, X-Plan-Limit, X-Plan-Overage, X-Plan-Period-End, X-Plan-Remaining.

  • 403Forbiddenforbidden_scope | forbidden_ip

    The key is valid but not allowed to make this call: it lacks the scope, or the request came from an address outside the key's allowlist.

  • 422InvalidRequestinvalid_request

    A parameter is malformed, out of range or mutually exclusive with another. `details` names the offending fields.

  • 429RateLimitedrate_limited | quota_exceeded

    Either the burst ceiling for the current minute or the daily quota is spent. Distinguish with the code: rate_limited clears within the minute, quota_exceeded does not clear until 00:00 UTC.

    Carries Retry-After, X-Quota-Limit, X-Quota-Remaining, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Request-Id.

  • 500InternalErrorinternal_error

    Something failed on our side. Internals are never leaked; quote the request id.

  • 503Unavailableupstream_timeout | upstream_error | not_configured

    The request could not be served right now. BRANCH ON error.code, not on the status: 'upstream_timeout' means a source was too slow (this is what a catalog query hitting its 15-second statement timeout returns, so it is reachable from any endpoint that reads the corpus, not only the live-scrape ones) and the same call is worth retrying with backoff - narrowing it with a smaller limit, a filtered scope or a less popular account makes it far less likely; 'upstream_error' means a source was unreachable, so back off further; 'not_configured' means the capability has no backing service in this deployment, and retrying will never help.

Every response carries X-Request-Id and meta.request_id. Quote it in support requests.

Coverage and limits

This endpoint is not platform-specific. Rate limits come from the tier on your key.

TierRequests a minuteRequests a dayLive reads a minute
free301,0005
standard12025,00020
pro600250,00060
unlimited6,00010,000,000600

This call only draws on the ordinary per-minute and per-day columns. Every response reports where you stand in X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and the X-Plan headers.

Start calling it

A key takes a minute to mint in the panel, no card. The reference covers authentication, the envelope, scopes, rate limits and every error code in one page.

Reference path: /data-api/reference/accounts-platforms

We value your privacy

We use cookies to improve our site, analyze traffic, and personalize ads. You can accept all, reject non-essential, or customize your choices. Read our Cookie Policy.