Users

Get a public list of users

GET

https://discourse.example.com/directory_items.json

curl -X GET 'https://discourse.example.com/directory_items.json?period=daily&order=likes_received'

const response = await fetch('https://discourse.example.com/directory_items.json?period=daily&order=likes_received', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('https://discourse.example.com/directory_items.json?period=daily&order=likes_received')
print(response.text)

200

{
  "directory_items": [
    {
      "id": 0,
      "likes_received": 0,
      "likes_given": 0,
      "topics_entered": 0,
      "topic_count": 0,
      "post_count": 0,
      "posts_read": 0,
      "days_visited": 0,
      "user": {
        "id": 0,
        "username": "string",
        "name": "string",
        "avatar_template": "string",
        "title": "string"
      }
    }
  ],
  "meta": {
    "last_updated_at": "string",
    "total_rows_directory_items": 0,
    "load_more_directory_items": "string"
  }
}

Parameters

periodstringdailyweeklymonthlyquarterlyyearlyallrequiredquery

orderstringlikes_receivedlikes_giventopic_countpost_counttopics_enteredposts_readdays_visitedrequiredquery

ascstringtruequery

pageintegerquery

Response

200OKany

directory items response

Response fields application/json

directory_itemsArray<object>required

Show child attributes

idintegerrequired

likes_receivedintegerrequired

likes_givenintegerrequired

topics_enteredintegerrequired

topic_countintegerrequired

post_countintegerrequired

posts_readintegerrequired

days_visitedintegerrequired

userobjectrequired

Show child attributes

idintegerrequired

usernamestringrequired

namestring | nullrequired

avatar_templatestringrequired

titlestring | nullrequired

metaobjectrequired

Show child attributes

last_updated_atstring | nullrequired

total_rows_directory_itemsintegerrequired

load_more_directory_itemsstringrequired

Docs by Sourcey