Concepts

Search the Hub-Equity concept catalog

Search the Hub-Equity concept catalog (canonical hubs across income statement, balance sheet, cash flow, ratio, metadata). Searches hub codes, labels and descriptions only.

Search is a case-insensitive substring match over name_en, description and code. Filters:

  • q — search string (optional ; when omitted, returns the catalog ordered by category × code).
  • category — restrict to one Hub category (income_statement, balance_sheet, cash_flow, ratio, metadata, equity_info).
  • limit 1-200, default 50 ; offset for pagination.

A Free key is enough.

get/api/v1/concepts/search

Request

  • Base URL: https://api.hub-equity.com
  • URL: https://api.hub-equity.com/api/v1/concepts/search
  • Auth: HTTP bearer

Query parameters

qstring nullable

Search string (case-insensitive substring match).

taxonomystring nullable

Taxonomy filter. Only hub (the default) is accepted; any other value returns 422.

categorystring nullable

Hub category restriction.

pageinteger nullable

Page number (1-based). Public idiom; overrides offset. Ignored when cursor is set.

per_pageinteger nullable

Results per page (1-200). Overrides limit.

limitinteger
offsetinteger
cursorstring nullable

Opaque cursor returned in next_cursor of the previous page. Mutually exclusive with offset/page — when provided, offset/page are ignored. Preferred over page/offset past page 200 (index-seek vs row-scan ; recommended for any client iterating the full catalog).

Response

Concept search results.

successboolean required

Changes

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