Skip to main content
GET
/
:projectId
/
entities
Fetch Entities
curl --request GET \
  --url https://api.replyke.com/api/v6/:projectId/entities
{
  "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

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

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

{
  "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
⌘I