> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macrobymark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Discovery Search

> Search across 2M+ provider series in the discovery catalog.



## OpenAPI

````yaml GET /api/indicators/discover
openapi: 3.1.0
info:
  title: Macro by Mark API
  version: 1.0.0
  description: |
    Public and authenticated API for the Macro by Mark macroeconomics platform.
    Covers indicator data, forecasting, discovery catalog, labs, account
    management, alerts, and administrative endpoints.
  contact:
    name: Mark Jayson Farol
    email: farolmarkjayson1313@gmail.com
  license:
    name: Proprietary
servers:
  - url: https://macrobymark.com
    description: Production
security: []
tags:
  - name: Health
    description: Platform health checks
  - name: Indicators
    description: Curated indicator library and per-series data
  - name: Discovery
    description: Discovery catalog search and series detail
  - name: Forecasting
    description: Time-series forecasting engine
  - name: Labs
    description: Econometric testing tools (stationarity, diagnostics)
  - name: Providers
    description: Passthrough data provider proxies (FRED, BEA, BLS, etc.)
  - name: News & Calendar
    description: Economic news feed and release calendar
  - name: Account
    description: User account, profile, preferences, workspace
  - name: Billing
    description: Stripe-backed subscription billing
  - name: Alerts
    description: Watchlist alert delivery
  - name: Admin
    description: Administrative and cron endpoints (requires CRON_SECRET)
  - name: Chat
    description: AI chat assistant
  - name: Import
    description: Indicator import pipeline
paths:
  /api/indicators/discover:
    get:
      tags:
        - Discovery
      summary: Search the discovery catalog (~2M series)
      description: |
        Full-text search across the discovery catalog backed by Postgres
        tsvector with GIN index. Supports faceted filtering by provider,
        country, frequency, topic, and region.
      operationId: searchDiscovery
      parameters:
        - name: q
          in: query
          schema:
            type: string
          description: Free-text search query
        - name: provider
          in: query
          schema:
            type: string
          description: Provider key filter (e.g. "fred", "worldbank")
        - name: country
          in: query
          schema:
            type: string
          description: ISO country code
        - name: frequency
          in: query
          schema:
            type: string
            enum:
              - daily
              - weekly
              - monthly
              - quarterly
              - annual
        - name: topic
          in: query
          schema:
            type: string
          description: Canonical topic slug
        - name: indicator
          in: query
          schema:
            type: string
        - name: region
          in: query
          schema:
            type: string
        - name: subdivision
          in: query
          schema:
            type: string
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
            maximum: 100
        - name: browse
          in: query
          schema:
            type: boolean
      responses:
        '200':
          description: Discovery search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscoverySearchResponse'
components:
  schemas:
    DiscoverySearchResponse:
      type: object
      properties:
        discoveryResults:
          type: array
          items:
            type: object
            properties:
              entry:
                type: object
                properties:
                  provider:
                    type: string
                  sourceSeriesKey:
                    type: string
                  title:
                    type: string
                  frequency:
                    type: string
                  countryCode:
                    type: string
                  countryName:
                    type: string
              score:
                type: number
        totalDiscoveryMatches:
          type: integer
        catalogs:
          type: object

````