Search

Project Event Search

Searches project events by keyword, optionally filtered by type.

Valid types: launch, upgrade, partnership, news, airdrop, listing, twitter.

Lookup: by UUID (id) or name (q). Returns 404 if the project is not found.

get/gateway/v1/search/events

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

idstring

Surf project UUID. PREFERRED — always use this when available from a previous response (e.g. project_id from /fund/portfolio or id from /search/project). Takes priority over q.

Example:25c6612a-395c-4974-94eb-3b5f9f4b2ed7
qstring

Fuzzy entity name search. Only use when 'id' is not available. May return unexpected results for ambiguous names.

Example:ethereum
type'launch' | 'upgrade' | 'partnership' | 'news' | 'airdrop' | 'listing' | 'twitter'

Filter by event type. Can be launch, upgrade, partnership, news, airdrop, listing, or twitter.

Example:launch
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseProjectEventItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.