Pomo

Pomo Market Intelligence API

The market-intelligence API from Pomo — 27 operation(s) for market-intelligence.

GitHub OpenAPI
Business capability
Market Intelligence Management BC-400.30

Operations 30

GET /api/market-intelligence/intelligence Get Market Intelligence #
GET /api/market-intelligence/intelligence/report-dates Get Intelligence Report Dates #
GET /api/market-intelligence/google-news/thumbnail Proxy Google News Thumbnail #
GET /api/market-intelligence/tiktok-video/thumbnail Proxy Tiktok Video Thumbnail #
GET /api/market-intelligence/ads-winners Get Ads Winners #
GET /api/market-intelligence/competitive-intelligence Get Competitive Intelligence #
PUT /api/market-intelligence/trend-suppressions Upsert Trend Suppression #
GET /api/market-intelligence/social-listening-mentions Get Social Listening Mentions #
GET /api/market-intelligence/social-listening-dashboard Get Social Listening Dashboard #
GET /api/market-intelligence/social-listening-summary Get Social Listening Summary #
GET /api/market-intelligence/social-listening-settings Get Social Listening Settings #
PUT /api/market-intelligence/social-listening-settings Update Social Listening Settings #
GET /api/market-intelligence/social-prospecting Get Social Prospecting #
GET /api/market-intelligence/social-prospecting/export Export Social Prospecting #
GET /api/market-intelligence/social-prospecting-settings Get Social Prospecting Settings #
PUT /api/market-intelligence/social-prospecting-settings Update Social Prospecting Settings #
PATCH /api/market-intelligence/social-prospecting-candidates/{candidate_id} Update Social Prospecting Candidate Status #
POST /api/market-intelligence/intelligence/generate Generate Market Intelligence #
GET /api/market-intelligence/intelligence/{intelligence_id} Get Intelligence Item #
PATCH /api/market-intelligence/intelligence/{intelligence_id} Update Intelligence Item #
POST /api/market-intelligence/intelligence/refresh Refresh Market Intelligence #
POST /api/market-intelligence/intelligence/evolution/analyze Analyze Market Evolution #
GET /api/market-intelligence/intelligence/evolution/history Get Evolution History #

Documentation

📖
APIReference
https://api.usepomo.ai/docs
📖
Documentation
https://api.usepomo.ai/redoc
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/authentication/pomo-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/rate-limits/pomo-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/openapi/pomo-market-intelligence-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/conventions/pomo-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/conventions/pomo-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/errors/pomo-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/data-model/pomo-data-model.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/lifecycle/pomo-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/conformance/pomo-conformance.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/asyncapi/pomo-event-surface.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/pomo-market-intelligence-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pomo-market-intelligence-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: GPT Backend Market Intelligence API
  version: 0.1.0
servers:
- url: https://api.usepomo.ai
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: market-intelligence
paths:
  /api/market-intelligence/intelligence:
    get:
      tags:
      - market-intelligence
      summary: Get Market Intelligence
      description: Get market intelligence data with filters.
      operationId: get_market_intelligence_api_market_intelligence_intelligence_get
      security:
      - HTTPBearer: []
      parameters:
      - name: intelligence_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Filter by type: trend, competitor, opportunity, threat'
          title: Intelligence Type
        description: 'Filter by type: trend, competitor, opportunity, threat'
      - name: impact_level
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Filter by impact level: low, medium, high, critical'
          title: Impact Level
        description: 'Filter by impact level: low, medium, high, critical'
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
      - name: product_offering_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          description: Filter by product offering ID (None = company-wide)
          title: Product Offering Id
        description: Filter by product offering ID (None = company-wide)
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back
          default: 30
          title: Days
        description: Number of days to look back
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Start date for filtering (YYYY-MM-DD)
          title: Start Date
        description: Start date for filtering (YYYY-MM-DD)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: End date for filtering (YYYY-MM-DD)
          title: End Date
        description: End date for filtering (YYYY-MM-DD)
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MarketIntelligenceResponse'
                title: Response Get Market Intelligence Api Market Intelligence Intelligence Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/intelligence/report-dates:
    get:
      tags:
      - market-intelligence
      summary: Get Intelligence Report Dates
      description: Get distinct dates when intelligence reports were generated.
      operationId: get_intelligence_report_dates_api_market_intelligence_intelligence_report_dates_get
      security:
      - HTTPBearer: []
      parameters:
      - name: product_offering_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          description: Product offering ID (None = company-wide)
          title: Product Offering Id
        description: Product offering ID (None = company-wide)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/google-trends:
    get:
      tags:
      - market-intelligence
      summary: Get Google Trends Analysis
      description: Fetch Google Trends analysis rows for the active company profile within the requested window.
      operationId: get_google_trends_analysis_api_market_intelligence_google_trends_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back (ignored when start_date is supplied)
          default: 14
          title: Days
        description: Number of days to look back (ignored when start_date is supplied)
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional start date (YYYY-MM-DD or ISO8601)
          title: Start Date
        description: Optional start date (YYYY-MM-DD or ISO8601)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional end date (YYYY-MM-DD or ISO8601)
          title: End Date
        description: Optional end date (YYYY-MM-DD or ISO8601)
      - name: include_details
        in: query
        required: false
        schema:
          type: boolean
          description: Return detailed fields (analysis, notable changes, recommendations, news)
          default: true
          title: Include Details
        description: Return detailed fields (analysis, notable changes, recommendations, news)
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/google-news/thumbnail:
    get:
      tags:
      - market-intelligence
      summary: Proxy Google News Thumbnail
      description: Proxy Google News thumbnail images to avoid CORS issues in the browser.
      operationId: proxy_google_news_thumbnail_api_market_intelligence_google_news_thumbnail_get
      security:
      - HTTPBearer: []
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
          description: Direct URL to the news thumbnail image
          title: Url
        description: Direct URL to the news thumbnail image
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/tiktok-video/thumbnail:
    get:
      tags:
      - market-intelligence
      summary: Proxy Tiktok Video Thumbnail
      description: Resolve a TikTok video URL to an oEmbed thumbnail and proxy the image to avoid browser CORS failures.
      operationId: proxy_tiktok_video_thumbnail_api_market_intelligence_tiktok_video_thumbnail_get
      security:
      - HTTPBearer: []
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
          description: TikTok video URL used to resolve the oEmbed thumbnail
          title: Url
        description: TikTok video URL used to resolve the oEmbed thumbnail
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/trends-bundle:
    get:
      tags:
      - market-intelligence
      summary: Get Trends Bundle
      description: Fetch the Trends page data in a single cached backend request.
      operationId: get_trends_bundle_api_market_intelligence_trends_bundle_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back (ignored when start_date is supplied)
          default: 14
          title: Days
        description: Number of days to look back (ignored when start_date is supplied)
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional start date (YYYY-MM-DD or ISO8601)
          title: Start Date
        description: Optional start date (YYYY-MM-DD or ISO8601)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional end date (YYYY-MM-DD or ISO8601)
          title: End Date
        description: Optional end date (YYYY-MM-DD or ISO8601)
      - name: include_details
        in: query
        required: false
        schema:
          type: boolean
          description: Return detailed trend fields for each platform
          default: true
          title: Include Details
        description: Return detailed trend fields for each platform
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      - name: include_social_mentions
        in: query
        required: false
        schema:
          type: boolean
          description: Include the legacy social-mentions section in the aggregate response
          default: true
          title: Include Social Mentions
        description: Include the legacy social-mentions section in the aggregate response
      - name: force_refresh
        in: query
        required: false
        schema:
          type: boolean
          description: Bypass the shared response cache
          default: false
          title: Force Refresh
        description: Bypass the shared response cache
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/yelp-trends:
    get:
      tags:
      - market-intelligence
      summary: Get Yelp Trends Analysis
      description: Fetch Yelp trends analysis rows for the active company profile within the requested window.
      operationId: get_yelp_trends_analysis_api_market_intelligence_yelp_trends_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back (ignored when start_date is supplied)
          default: 14
          title: Days
        description: Number of days to look back (ignored when start_date is supplied)
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional start date (YYYY-MM-DD or ISO8601)
          title: Start Date
        description: Optional start date (YYYY-MM-DD or ISO8601)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional end date (YYYY-MM-DD or ISO8601)
          title: End Date
        description: Optional end date (YYYY-MM-DD or ISO8601)
      - name: include_details
        in: query
        required: false
        schema:
          type: boolean
          description: Return detailed fields (analysis, notable changes, recommendations, search results)
          default: true
          title: Include Details
        description: Return detailed fields (analysis, notable changes, recommendations, search results)
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/amazon-trends:
    get:
      tags:
      - market-intelligence
      summary: Get Amazon Trends Analysis
      description: Fetch Amazon trends analysis rows for the active company profile within the requested window.
      operationId: get_amazon_trends_analysis_api_market_intelligence_amazon_trends_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back (ignored when start_date is supplied)
          default: 14
          title: Days
        description: Number of days to look back (ignored when start_date is supplied)
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional start date (YYYY-MM-DD or ISO8601)
          title: Start Date
        description: Optional start date (YYYY-MM-DD or ISO8601)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional end date (YYYY-MM-DD or ISO8601)
          title: End Date
        description: Optional end date (YYYY-MM-DD or ISO8601)
      - name: include_details
        in: query
        required: false
        schema:
          type: boolean
          description: Return detailed fields (analysis, notable changes, recommendations, best sellers)
          default: true
          title: Include Details
        description: Return detailed fields (analysis, notable changes, recommendations, best sellers)
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/youtube-trends:
    get:
      tags:
      - market-intelligence
      summary: Get Youtube Trends Analysis
      description: Fetch YouTube trends analysis rows for the active company profile within the requested window.
      operationId: get_youtube_trends_analysis_api_market_intelligence_youtube_trends_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back (ignored when start_date is supplied)
          default: 14
          title: Days
        description: Number of days to look back (ignored when start_date is supplied)
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional start date (YYYY-MM-DD or ISO8601)
          title: Start Date
        description: Optional start date (YYYY-MM-DD or ISO8601)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional end date (YYYY-MM-DD or ISO8601)
          title: End Date
        description: Optional end date (YYYY-MM-DD or ISO8601)
      - name: include_details
        in: query
        required: false
        schema:
          type: boolean
          description: Return detailed fields (analysis, notable changes, recommendations, videos)
          default: true
          title: Include Details
        description: Return detailed fields (analysis, notable changes, recommendations, videos)
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/ads-winners:
    get:
      tags:
      - market-intelligence
      summary: Get Ads Winners
      description: Fetch TikTok top ads selected by company matching results.
      operationId: get_ads_winners_api_market_intelligence_ads_winners_get
      security:
      - HTTPBearer: []
      parameters:
      - name: search_mode
        in: query
        required: false
        schema:
          enum:
          - general
          - precise
          type: string
          description: general uses candidate_video_ids; precise uses related_tiktok_topads
          default: general
          title: Search Mode
        description: general uses candidate_video_ids; precise uses related_tiktok_topads
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsWinnerResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/competitive-intelligence:
    get:
      tags:
      - market-intelligence
      summary: Get Competitive Intelligence
      description: Fetch business intelligence snapshots for the active company profile.
      operationId: get_competitive_intelligence_api_market_intelligence_competitive_intelligence_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back
          default: 90
          title: Days
        description: Number of days to look back
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Start date for filtering (YYYY-MM-DD)
          title: Start Date
        description: Start date for filtering (YYYY-MM-DD)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: End date for filtering (YYYY-MM-DD)
          title: End Date
        description: End date for filtering (YYYY-MM-DD)
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          default: 25
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompetitiveIntelligenceRecord'
                title: Response Get Competitive Intelligence Api Market Intelligence Competitive Intelligence Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/tiktok-trends:
    get:
      tags:
      - market-intelligence
      summary: Get Tiktok Trends Analysis
      description: Fetch TikTok trends analysis rows for the active company profile within the requested window.
      operationId: get_tiktok_trends_analysis_api_market_intelligence_tiktok_trends_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back (ignored when start_date is supplied)
          default: 14
          title: Days
        description: Number of days to look back (ignored when start_date is supplied)
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional start date (YYYY-MM-DD or ISO8601)
          title: Start Date
        description: Optional start date (YYYY-MM-DD or ISO8601)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional end date (YYYY-MM-DD or ISO8601)
          title: End Date
        description: Optional end date (YYYY-MM-DD or ISO8601)
      - name: include_details
        in: query
        required: false
        schema:
          type: boolean
          description: Return detailed fields (analysis, notable changes, recommendations, videos)
          default: true
          title: Include Details
        description: Return detailed fields (analysis, notable changes, recommendations, videos)
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/instagram-trends:
    get:
      tags:
      - market-intelligence
      summary: Get Instagram Trends Analysis
      description: Fetch Instagram trends analysis rows for the active company profile within the requested window.
      operationId: get_instagram_trends_analysis_api_market_intelligence_instagram_trends_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          description: Number of days to look back (ignored when start_date is supplied)
          default: 14
          title: Days
        description: Number of days to look back (ignored when start_date is supplied)
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional start date (YYYY-MM-DD or ISO8601)
          title: Start Date
        description: Optional start date (YYYY-MM-DD or ISO8601)
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional end date (YYYY-MM-DD or ISO8601)
          title: End Date
        description: Optional end date (YYYY-MM-DD or ISO8601)
      - name: include_details
        in: query
        required: false
        schema:
          type: boolean
          description: Return detailed fields (analysis, notable changes, recommendations, posts)
          default: true
          title: Include Details
        description: Return detailed fields (analysis, notable changes, recommendations, posts)
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/trend-suppressions:
    put:
      tags:
      - market-intelligence
      summary: Upsert Trend Suppression
      operationId: upsert_trend_suppression_api_market_intelligence_trend_suppressions_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TrendSuppressionUpsertRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrendSuppressionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/market-intelligence/social-listening-mentions:
    get:
      tags:
      - market-intelligence
      summary: Get Social Listening Mentions
      description: 'Fetch recent social listening mentions ordered by created_datetime.

        Optionally filter to a specific competitor.'
      operationId: get_social_listening_mentions_api_market_intelligence_social_listening_mentions_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 365
            minimum: 1
          - type: 'null'
          description: Number of days to look back
          title: Days
        description: Number of days to look back
      - name: include_meta
        in: query
        required: false
        schema:
          type: boolean
          description: Include preview metadata for tier-limited responses
          default: false
          title: Include Meta
        description: Include preview metadata for tier-limited responses
      - name: competitor_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          description: Filter by competitor ID
          title: Competitor Id
        description: Filter by competitor ID
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/social-listening-dashboard:
    get:
      tags:
      - market-intelligence
      summary: Get Social Listening Dashboard
      description: Fetch the v2 social listening command-center payload for the active company.
      operationId: get_social_listening_dashboard_api_market_intelligence_social_listening_dashboard_get
      security:
      - HTTPBearer: []
      parameters:
      - name: company_profile_id
        in: query
        required: true
        schema:
          type: string
          format: uuid
          description: Company profile ID
          title: Company Profile Id
        description: Company profile ID
      - name: days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 365
            minimum: 1
          - type: 'null'
          description: Optional dashboard lookback override
          title: Days
        description: Optional dashboard lookback override
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/social-listening-summary:
    get:
      tags:
      - market-intelligence
      summary: Get Social Listening Summary
      description: 'Fetch the latest pipeline-generated social-listening summary for the company profile.

        The v2 ingestion job owns summary generation; this route does not run a one-off AI summary.'
      operationId: get_social_listening_summary_api_market_intelligence_social_listening_summary_get
      security:
      - HTTPBearer: []
      parameters:
      - name: company_profile_id
        in: query
        required: true
        schema:
          type: string
          format: uuid
          description: Company profile ID
          title: Company Profile Id
        description: Company profile ID
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialListeningSummaryResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/market-intelligence/social-listening-settings:
    get:
      tags:
      - market-intelligence
      summary: Get Social Listening Settings
      description: Fetch company-level social listening scan settings.
      operationId: get_social_listening_settings_api_market_intelligence_social_listening_settings_get
      security:
      - HTTPBearer: []
      parameters:
      - name: company_profile_id
        in: query
        required: true
        schema:
          type: string
          format: uuid
          description: Company profile ID
          title: Company Profile Id
        description: Company profile ID
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
          

# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/pomo/refs/heads/main/openapi/pomo-market-intelligence-api-openapi.yml