> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sublay.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Fetch many entities
> Fetch a paginated, filtered, and sorted list of entities
export const SpaceReputationParams = ({variant = "context", field = "path"}) => {
const isUser = variant === "user";
return <>
Opt-in. Adds a spaceReputation number to each returned user,
scoped to a single space. Requires the reputation bundle.
The reputation total is always present regardless;{" "}
spaceReputation is purely additive and only appears when you
pass this object. This object is the primary form — it
replaces the deprecated flat props below. See the{" "}
Reputation data model for the
full contract.
{isUser ?
Which bucket to read. A space <uuid> reads that
space's bucket; "none" reads the
project-general (space-less) bucket.{" "}
"context" is rejected (400) on this
endpoint — there is no space context to derive. The empty string
and the legacy general / null aliases are
also rejected. Missing buckets read as 0.
:
Which bucket to read. One of: a space <uuid>{" "}
(that space's bucket), "none" (the
project-general, space-less bucket), or{" "}
"context" (the space derived from the
request context — resolved per-row on lists, or the single space on
member/team/conversation surfaces). The empty string and the legacy{" "}
general / null aliases are rejected (400).
Missing buckets read as 0.
}
Only honored when spaceId is an explicit space <uuid>.
When true, spaceReputation is the{" "}
subtree sum — the named space plus all of its
descendant spaces (the root space's own bucket included). Ignored for{" "}
"none"; not allowed with "context".
{isUser ?
Deprecated — use the spaceReputation{" "}
object instead. The flat form of spaceReputation.spaceId.
Still accepted (the object wins if both are passed); removal is a later
major version. Accepts a space <uuid> or "none" only —{" "}
"context" is rejected (400) on this endpoint.
:
Deprecated — use the spaceReputation{" "}
object instead. The flat form of spaceReputation.spaceId.
Still accepted (the object wins if both are passed); removal is a later
major version. Accepts a space <uuid>, "none", or{" "}
"context".
}
Deprecated — use{" "}
spaceReputation.includeDescendants instead. The flat form,
only honored alongside an explicit spaceReputationId <uuid>.
;
};
**Requires the `entities` bundle.** A project without the entities bundle returns `403 database/tables-not-available`. See [Bundles](/v8/bundles).
## Overview
`useFetchManyEntities` returns a function that fetches a paginated list of entities with full filtering and sorting support. This is the low-level hook underlying `EntityListProvider`. For continuous-scroll or load-more list UIs, use [`useEntityList`](/v8/hooks/entity-lists/use-entity-list) instead, which wraps this hook with built-in pagination state.
## Usage Example
```tsx theme={null}
import { useFetchManyEntities } from "@sublay/react-js";
import { useEffect, useState } from "react";
function EntityFeed() {
const fetchEntities = useFetchManyEntities();
const [entities, setEntities] = useState([]);
useEffect(() => {
fetchEntities({
page: 1,
limit: 20,
sortBy: "score",
spaceId: "space_abc",
include: ["user"],
}).then((res) => setEntities(res.data));
}, []);
return (
{entities.map((e) => (
- {e.title}
))}
);
}
```
## Parameters
Page number (1-indexed). Defaults to `1`.
Results per page. Defaults to server default.
Field to sort by. Options: `"createdAt"`, `"top"`, `"hot"`, `"controversial"`, or `"metadata."` to sort by a metadata field.
Which reaction `top` ranks by. Only sent when `sortBy` is `"top"`; ignored for every other sort.
Sort direction: `"asc"` or `"desc"`.
Sort algorithm type. Options: `"auto"`, `"numeric"`, `"text"`, `"boolean"`, `"timestamp"`. Used when sorting by a metadata field.
Filter entities to a time window. Options: `"day"`, `"week"`, `"month"`, `"year"`.
Filter to entities associated with a specific source ID.
Filter to entities in a specific space.
Filter to entities created by a specific user.
If `true`, return only entities from users the authenticated user follows.
Filter by keywords. See [Entity List Filters](/v8/sdk/entity-lists/filters) for the full filter schema.
Filter by title content. See [Entity List Filters](/v8/sdk/entity-lists/filters).
Filter by body content. See [Entity List Filters](/v8/sdk/entity-lists/filters).
Filter by attachments data. See [Entity List Filters](/v8/sdk/entity-lists/filters).
Filter by geographic proximity. See [Entity List Filters](/v8/sdk/entity-lists/filters).
Filter by metadata fields. See [Entity List Filters](/v8/sdk/entity-lists/filters).
Filter by **effective** NSFW status (`entity.nsfw OR its space's nsfwEffective`). `"include-all"` (default) adds no predicate; `"exclude"` drops effective-NSFW entities; `"only"` returns only effective-NSFW entities. On projects without the spaces bundle it applies against the entity's own `nsfw` flag alone. See [Entity NSFW flagging](/v8/data-models/entity#nsfw-flagging).
Populate related fields. Accepted values: `"user"`, `"space"`, `"topComments"`, `"saved"`, `"files"`, `"grants"`.
With `"topComments"` included: how many top comments per entity. Server default `1`, maximum `5`. Not sent when `include` doesn't contain `"topComments"`.
With `"topComments"` included: the reaction whose raw count ranks the top comments. Server default `"upvote"`. Not sent when `include` doesn't contain `"topComments"`.
## Returns
Array of entities for the current page. When `spaceReputation` is requested, each embedded author carries an added `spaceReputation` number. See [Reputation](/v8/data-models/reputation).
Current page number.
Number of results per page.
Total number of pages matching the filters.
Total count of entities matching the filters (across all pages).
`true` if there are additional pages available.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.