/Events-by-Author

This endpoint is useful for retrieving an organized array of events published by an author, along with the profiles of all users involved.

Overview

The /events-by-author endpoint retrieves the latest events created by a specific author (identified by their public key). It returns a list of events along with the author's profile information.

Endpoint Details

• URL: /events-by-author

• Method: GET

• Auth Required: No

• Permissions Required: None

Request Parameters

Parameter	Description	Required
pubkey	The public key of the author whose events are to be fetched.	Yes
limit	The maximum number of events to return. Defaults to 20 if not provided.	No
kinds	Comma-separated list of event kinds to filter by. Defaults to all kinds if not provided.	No
until	Unix timestamp in seconds. If provided, fetch only events that were created before this time.	No

Response Schema

The response is a JSON object with the following structure:

{
  "pubkey": "author_pubkey",
  "profiles": {
    "author_pubkey": {
      "id": "profile_event_id",
      "pubkey": "author_pubkey",
      "created_at": 1234567890,
      "kind": 0,
      "tags": [],
      "content": "Profile content",
      "sig": "profile_signature"
    }
  },
  "events": [
    {
      "id": "event_id",
      "pubkey": "author_pubkey",
      "created_at": 1234567890,
      "kind": 1,
      "tags": [],
      "content": "Event content",
      "sig": "event_signature"
    }
  ]
}

• pubkey: The public key of the author whose events are being returned.

• profiles: A map containing the author's profile information.

• events: An array of events created by the author, sorted by creation time in descending order.

Example Call

curl -X GET "https://huddlers-ovduv.ondigitalocean.app/events-by-author?pubkey=82341f882b6eabcd2ba7f1ef90aad961cf074af15b9ef44a09f9d2a8fbfbe6a2&limit=10&kinds=1,6"

Notes

• Events are sorted by creation time, with the most recent events first.

• The profiles map also includes authors of reposts.

Error Responses

• 400 Bad Request: If the pubkey is missing or invalid.

• 404 Not Found: If no events or profile information can be found for the given pubkey.

• 500 Internal Server Error: If there's an issue processing the request.