Skip to main content
GET
/
gateway
/
v1
/
search
/
events
Project Event Search
curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/search/events
{
  "data": [
    {
      "title": "<string>",
      "type": "<string>",
      "date": "<string>",
      "description": "<string>",
      "logo_url": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
id
string

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"

​
q
string

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

Example:

"ethereum"

​
type
enum<string>

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

Available options:
launch,
upgrade,
partnership,
news,
airdrop,
listing,
twitter
Example:

"launch"

​
limit
integer<int64>
default:20

Results per page

Required range: 1 <= x <= 100
Example:

20

​
offset
integer<int64>
default:0

Pagination offset

Required range: x >= 0
Example:

0

Response

OK

​
data
object[] | null
required
​
meta
object
required
​
$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseProjectEventItem.json"