Channel Search


Scope: none

Retrieve a list of channels filtered by the given criteria.

Query Parameters


Name Description
q Basic text string searched for in names and descriptions in a channel's raw.


Name Description
order One of activity (most recent message), id (most recently created), or popularity (how many messages have been made). Default is by activity.


Name Description
categories Comma-separated list of: fun, lifestyle, profession, language, community, tech, event, general. Taken from raw
channel_types Comma-separated list of channel types to include
created_after ISO 8601-formatted timestamp after which channels were created
created_before ISO 8601-formatted timestamp before which channels were created
owner_id Channels owned by the included user ID
exclude_channel_types Comma-separated list of channel types to exclude
file_id Matches with this file attached
is_public 1 or 0 to only include public- or private-readable channels
raw_types Comma-separated list of attached raw types. Any matches returned
curl "" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of channels

    "meta": {
        "more": false,
        "max_id": "0",
        "min_id": "0",
        "code": 200
    "data": [
        {"...Channel Object..."}