Endpoint
Request Headers
| Header | Required | Description |
|---|---|---|
X-RP-API-Key | Yes | Your App Key, in the format rp_app_xxxxxxxxxxxxxxxx. Obtain this from the developer portal. |
Query Parameters
A search term for filtering events. Matched against event titles, descriptions, and organizer names. For example,
AI, startup, or design.Language code for the response content. Common values are
ko (Korean) and en (English). Rocketpunch supports 11 languages and returns a consistent schema across all of them.The page number to retrieve. Page numbering starts at
1. Use together with per_page to paginate through large result sets.The number of events to return per page. Adjust this to control payload size and the number of requests required for a full data traversal.
Example Request
Response
A successful request returns HTTP200 with a JSON body containing a paginated list of event objects under the items key.
The field values shown above are illustrative examples. Actual values depend on live event data at query time. Fields such as
end_date or location may be null for events where that information has not been provided by the organizer.Response Fields
An array of event objects matching your query. Returns an empty array if no events match the given keyword.
The total number of events matching your query across all pages.
The current page number reflected in this response.
The number of results per page reflected in this response.
Error Responses
| HTTP Status | Meaning |
|---|---|
401 Unauthorized | Your X-RP-API-Key is missing or invalid. |
429 Too Many Requests | You have exceeded your plan’s rate limit. |
500 Internal Server Error | An unexpected server-side error occurred. Retry with exponential backoff. |