Collections

Create collection

Create a new multi-source news collection. Defaults to type 'news'. Available types: news, stock_portfolio (beta), regulatory (beta). Types crypto and prediction_markets are coming soon and will return a validation error.

post/collections

Request

  • Base URL: https://studio.fintechstudios.com/api/v1
  • URL: https://studio.fintechstudios.com/api/v1/collections
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

namestring required
descriptionstring
type'news' | 'stock_portfolio' | 'regulatory'
refresh_intervalinteger

Auto-refresh interval in minutes

max_articles_per_refreshinteger

Default result cap for every execute of this collection, used when the request omits max_articles. Omit for unbounded within the window.

type_configobject

Type-specific configuration (e.g., stock holdings)

Example request

{
  "name": "Tech Industry News",
  "sources": [
    {
      "provider_id": "news"
    }
  ],
  "global_filters": {
    "query": "semiconductor supply chain",
    "date_range": {
      "relative": "30d"
    }
  }
}

Response

Collection created

Example response

{
  "meta": {
    "request_id": "req_abc123def456",
    "credits_used": 1,
    "credits_remaining": 199,
    "rate_limit": {
      "limit": 1000,
      "remaining": 999,
      "reset": 1709251200
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.