Fetch Entities

Fetch a list of entities with pagination, sorting, and advanced filtering

GET /:projectId/entities

Fetch Entities

cURL

curl --request GET \
  --url https://api.replyke.com/api/v6/:projectId/entities

200

{
  "id": "<string>",
  "userId": "<string>",
  "title": "<string>",
  "content": "<string>",
  "keywords": [
    {}
  ],
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Fetches a list of entities with full support for pagination, sorting, and advanced filtering. Can be accessed with or without authentication.

Query Parameters

page · number · default: "1"

Page number

limit · number · default: "10"

Number of results per page (max: 100)

sortBy · string · default: "hot"

Sorting strategy: hot (default), top, new, or controversial

timeFrame · string

Filter by creation time: hour, day, week, month, year

sourceId · string

Filter entities by a specific sourceId

userId · string

Filter by a specific userId

followedOnly · string

Set to true to only show entities by followed users (requires authentication)

keywordsFilters · object

Filter entities by keyword inclusion/exclusion

metadataFilters · object

Filter entities by metadata keys and values

titleFilters · object

Filter by title presence or matching values

contentFilters · object

Filter by content presence or matching values

attachmentsFilters · object

Filter based on whether attachments exist

locationFilters · object

Filter by location with radius, latitude, and longitude

Response

Returns an array of entity objects.

id · string

Unique entity identifier

userId · string

ID of the user who created the entity

title · string

Entity title

content · string

Entity content

keywords · array

Array of keywords

createdAt · string

Creation timestamp in ISO 8601 format

updatedAt · string

Last update timestamp in ISO 8601 format

Error Responses

Invalid Limit - 400 Bad Request

{
  "error": "Invalid request: limit must be a positive number.",
  "code": "entity/invalid-limit"
}

Invalid Page - 400 Bad Request

{
  "error": "Invalid request: page must be a whole number greater than 0.",
  "code": "entity/invalid-page"
}

Server Error - 500 Internal Server Error

{
  "error": "Internal server error.",
  "code": "entity/server-error",
  "details": "<Error message>"
}

---

Notes

Sort Options

• hot: Ranked by score (default)
• top: Most upvoted
• new: Most recent
• controversial: Balanced upvotes/downvotes

Filtering

• When followedOnly is true, the response includes only posts by followed users (must be logged in)
• Supports complex filters including geospatial queries, keyword matching, content presence, and metadata rules