Surf/Docs

Project AI News

GET/gateway/v1/project/ai-news

Lookup: by UUID (`id`) or name (`q`). Filter by `lang` (en/zh/ja/kr). Returns 404 if not found.

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
limitinteger

Results per page

Example: 20
offsetinteger

Pagination offset

Example: 0
langenum<string>

Language for AI-generated content

Available options:enzhjakr
Example: en
Project AI News
const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/project/ai-news?id=25c6612a-395c-4974-94eb-3b5f9f4b2ed7&q=ethereum&limit=20&offset=0&lang=en', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
OK
{
  "$schema": "https://example.com/schemas/DataResponseProjectPulseItem.json",
  "data": [
    {
      "id": "<string>",
      "signal_type": "<string>",
      "slug": "<string>",
      "sources": [],
      "subtitle": "<string>",
      "timestamp": 123,
      "title": "<string>",
      "tldr": []
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}