---
title: "Read the social marketing catalogue with combined filters and pagination (free)"
method: GET
path: "/smm/v1/smm-services"
tags: ["SMM"]
---

# Read the social marketing catalogue with combined filters and pagination (free)

`GET /smm/v1/smm-services`

## Request

- Base URL: `https://agent.connskill.com` (the document declares no server; this is the origin it was published from)
- URL: `https://agent.connskill.com/smm/v1/smm-services`
- Auth: none required

## Query parameters

- `category` string
- `categoryExact` string
- `q` string
- `limit` integer
- `offset` integer
- `sellable` 'true' | 'false'

## Response `200`

total = provider catalogue rows; matched = filtered count before pagination; shown = actual returned rows. Unknown numeric metadata is null. No payment or provider order is created.

- object
  - `ok` unknown, required
  - `total` integer, required
  - `matched` integer, required
  - `shown` integer, required
  - `offset` integer, required
  - `limit` integer, required
  - `hasMore` boolean, required
  - `services` object[], required
    - `providerType` string, nullable, required
    - `providerDripfeed` boolean, nullable, required
    - `gatewayDripfeed` unknown, required
    - `gatewaySupport` object, required
      - `status` 'basic' | 'unsupported' | 'unknown', required
      - `reason` 'basic_link_quantity_contract_only' | 'provider_type_unknown' | 'provider_type_not_integrated', required
      - `inputFields` string[], required
    - `serviceId` union, required
      - integer
      - string
    - `name` string, required
    - `category` string, required
    - `ratePer1000Usd` number, nullable, required
    - `sellPer1000Usd` number, nullable, required
    - `min` number, nullable, required
    - `max` number, nullable, required
    - `refill` boolean, required
    - `cancel` boolean, required

## Other responses

- `400`: Invalid or repeated known parameter; never reflects its value.
- `502`: Provider catalogue unavailable or malformed, without provider response details.

---

[API](https://skmtc.dev/connskill/apis/connskill-growth-services.md) · [All operations](https://skmtc.dev/connskill/apis/connskill-growth-services/llms.txt) · [OpenAPI document](https://skmtc.dev/connskill/apis/connskill-growth-services/revisions/aae873ea0805?raw)