Lucidya

Lucidya Ltd Public APIs - Social Listening - Base APIs API

The Public APIs - Social Listening - Base APIs API from Lucidya Ltd — 3 operation(s) for public apis - social listening - base apis.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /widgets List widgets for a social listening monitor · Social Listening - Base APIs #
Ask an LLM
“What widgets are available on my social listening monitor?”
“Which widget names can I use for a monitor's page and data source?”
Tell an agent
List widgets for monitor {monitor_id} on page {page_name}.
Show widgets for monitor {monitor_id} from data source {data_source} in product {product_id}.
GET /filters Get filters for a social listening monitor · Social Listening - Base APIs #
Ask an LLM
“Which filters can I apply to my monitor's data?”
“What filter options exist for a monitor's page and data source?”
Tell an agent
Get the available filters for monitor {monitor_id} on page {page_name}.
Show filter options for monitor {monitor_id} data source {data_source}.
GET /pages List pages for a social listening monitor · Social Listening - Base APIs #
Ask an LLM
“Which pages does my social listening monitor have for a data source?”
“What page names can I use when requesting monitor widgets?”
Tell an agent
List the pages for monitor {monitor_id} on {data_source}.
Get page names monitor {monitor_id} exposes for {data_source}.

Documentation

📖
Documentation
https://docs.lucidya.com/docs/Social-Listening-api/rqwky70duwx76-get-started
📖
APIReference
https://docs.lucidya.com/docs/Social-Listening-api/wainb9dny9w1y-lucidya-social-listening-public-api
📖
GettingStarted
https://docs.lucidya.com/docs/Social-Listening-api/rqwky70duwx76-get-started
📖
Authentication
https://docs.lucidya.com/docs/Social-Listening-api/uh64vtmx7x4kl-authorization
📖
Documentation
https://docs.lucidya.com/docs/ai-api/l9nsga0nmis4v-get-started
📖
APIReference
https://docs.lucidya.com/docs/ai-api/zl9th61r4qjdz-lucidya-public-ai-api
📖
GettingStarted
https://docs.lucidya.com/docs/ai-api/l9nsga0nmis4v-get-started
📖
Authentication
https://docs.lucidya.com/docs/ai-api/sjq8uo8o8lt93-authorization
📖
Documentation
https://docs.lucidya.com/docs/cdp-api/lnrpbrm3b9yp9-get-started
📖
APIReference
https://docs.lucidya.com/docs/cdp-api/ns8sfqyr1dgw6-cdp-customer-data-platform-api
📖
GettingStarted
https://docs.lucidya.com/docs/cdp-api/lnrpbrm3b9yp9-get-started
📖
Authentication
https://docs.lucidya.com/docs/cdp-api/6tqmgs82r4jxa-authorization
📖
Documentation
https://docs.lucidya.com/docs/omnichannel-api/q1nc0ntpokxgs-get-started
📖
APIReference
https://docs.lucidya.com/docs/omnichannel-api/d1ow4caem6i5x-omni-channel-api
📖
GettingStarted
https://docs.lucidya.com/docs/omnichannel-api/q1nc0ntpokxgs-get-started
📖
Authentication
https://docs.lucidya.com/docs/omnichannel-api/cfqqlsohea8mv-authorization
📖
Documentation
https://docs.lucidya.com/docs/omniserve/jjdvsz08tba5c-get-started
📖
APIReference
https://docs.lucidya.com/docs/omniserve/mjhuba7fdw882-omni-serve-analytics-api
📖
GettingStarted
https://docs.lucidya.com/docs/omniserve/jjdvsz08tba5c-get-started
📖
Authentication
https://docs.lucidya.com/docs/omniserve/8s65uy0al6adj-authorization

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lucidya-ltd/refs/heads/main/openapi/lucidya-ltd-public-apis-social-listening-base-apis-api-openapi.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/lucidya-ltd:lucidya-ltd-public-apis-social-listening-base-apis-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

lucidya-ltd-public-apis-social-listening-base-apis-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: v1
  title: Lucidya Social Listening Public Public APIs - Social…
  description: This is the Public API Reference for the Social Listening Product. Use our Social Listening Endpoints to integrate with your product.
  termsOfService: https://lucidya.com/service-agreement/
  contact:
    name: Lucidya Support
    url: https://lucidya.com/
    email: customer.support@lucidya.com
servers:
- url: https://api.lucidya.com
  description: Production
tags:
- name: Public APIs - Social Listening - Base APIs
paths:
  /widgets:
    get:
      tags:
      - Public APIs - Social Listening - Base APIs
      summary: Social Listening - Base APIs
      description: This endpoint enanles you to get all widgets from your account.
      operationId: Widgets
      parameters:
      - name: luc-authorization
        in: header
        description: The API authorization token for the request.
        required: true
        schema:
          type: string
      - name: monitor_id
        in: query
        description: The ID of the monitor being used.
        required: true
        schema:
          type: integer
          example: 7709
        examples:
          default:
            value: 7709
      - name: product_id
        in: query
        description: The ID of the product being monitored.
        required: true
        schema:
          type: integer
          example: 1
        examples:
          default:
            value: 1
      - name: page_name
        in: query
        description: The name of the page being monitored.
        required: true
        schema:
          type: string
          example: account_page
        examples:
          default:
            value: account_page
      - name: data_source
        in: query
        description: The data source being used for monitoring.
        required: true
        schema:
          type: string
          example: twitter
        examples:
          default:
            value: twitter
      responses:
        '200':
          description: successful operation
          content:
            example_0:
              examples:
                example_0:
                  value:
                    data:
                      data_source: twitter
                      widgets_names:
                      - volume_overtime
                      - interactions
                      - sentiment_analysis
                      - reach_funnel
                      - content_style
                      - associated_topics
                      - top_keywords
                      - top_hashtags
                      - top_images
                      - top_videos
                      - top_languages
                      - dialects_subdialects
                      - top_countries
                      - top_cities
                      - gender_distribution
                      - account_types
                      - top_engagers
                      - top_sources
                      - top_verified_engagers
                      - top_influencers
                      company_time_zone: 3
                      page_name: engagements
                      monitor_id: 1234
                      monitor_name: dummy monitor
        '400':
          description: failure of getting data due to missing params
          content:
            example_0:
              examples:
                example_0:
                  value:
                    error:
                      status: 400
                      detail: WRONG_REQUEST_PARAMETERS
        '401':
          description: missing_API_key
          content:
            example_0:
              examples:
                example_0:
                  value:
                    message: No API key found in request
            example_1:
              examples:
                example_0:
                  value:
                    message: Invalid authentication credentials
        '403':
          description: not_authorized
        '404':
          description: Page Not Found or Monitor Not Found
          content:
            example_0:
              examples:
                example_0:
                  value:
                    error:
                      source: {}
                      status: 404
                      detail: PAGE_NOT_FOUND
            example_1:
              examples:
                example_0:
                  value:
                    error:
                      status: 404
                      detail: Couldn't find MonitorModel with 'id'=1235
        '429':
          description: too_many_requests
          content:
            example_0:
              examples:
                example_0:
                  value:
                    message: API rate limit exceeded
        '500':
          description: internal_server_error
        '503':
          description: service_unavailable
        '504':
          description: request_timeout
      servers:
      - url: https://api.lucidya.com
        description: Production
  /filters:
    get:
      tags:
      - Public APIs - Social Listening - Base APIs
      summary: Social Listening - Base APIs
      description: This endpoint enables you to apply filters for specific monitor data.
      operationId: filters
      parameters:
      - name: luc-authorization
        in: header
        description: The API authorization token for the request.
        required: true
        schema:
          type: string
      - name: monitor_id
        in: query
        description: The ID of the monitor being used.
        required: true
        schema:
          type: integer
          example: 7709
        examples:
          default:
            value: 7709
      - name: data_source
        in: query
        description: The data source being used for monitoring.
        required: true
        schema:
          type: string
          example: twitter
        examples:
          default:
            value: twitter
      - name: product_id
        in: query
        description: The ID of the product being monitored.
        required: true
        schema:
          type: integer
          example: 1
        examples:
          default:
            value: 1
      - name: page_name
        in: query
        description: The name of the page being monitored.
        required: true
        schema:
          type: string
          example: account_page
        examples:
          default:
            value: account_page
      responses:
        '200':
          description: Return all filters for a specific data_source Page
          content:
            example_0:
              examples:
                example_0:
                  value:
                    data:
                    - name: sentiment
                      selection_attribute: checkbox-labels
                      content_source: static_content
                      placeholder: 'null'
                      locale_source: 'null'
                      default_value: 'null'
                      priority: '1'
                      options:
                      - value: '1'
                        color: green
                        label: Positive
                      - value: '0'
                        color: red
                        label: Negative
                      - value: 2,3
                        color: yellow
                        label: Neutral
        '401':
          description: missing_API_key
          content:
            example_0:
              examples:
                example_0:
                  value:
                    message: No API key found in request
            example_1:
              examples:
                example_0:
                  value:
                    message: Invalid authentication credentials
        '403':
          description: not_authorized
        '404':
          description: Page Not Found or Monitor Not Found
          content:
            example_0:
              examples:
                example_0:
                  value:
                    error:
                      source: {}
                      status: 404
                      detail: PAGE_NOT_FOUND
            example_1:
              examples:
                example_0:
                  value:
                    error:
                      status: 404
                      detail: Couldn't find MonitorModel with 'id'=1235
        '429':
          description: too_many_requests
          content:
            example_0:
              examples:
                example_0:
                  value:
                    message: API rate limit exceeded
        '500':
          description: internal_server_error
        '503':
          description: service_unavailable
        '504':
          description: request_timeout
      servers:
      - url: https://api.lucidya.com
        description: Production
  /pages:
    get:
      tags:
      - Public APIs - Social Listening - Base APIs
      summary: Social Listening - Base APIs
      description: This endpoint enables you to get specific page data from your account.
      operationId: pages
      parameters:
      - name: luc-authorization
        in: header
        description: The API authorization token for the request.
        required: true
        schema:
          type: string
      - name: monitor_id
        in: query
        description: The ID of the monitor being used.
        required: true
        schema:
          type: integer
          example: 7709
        examples:
          default:
            value: 7709
      - name: data_source
        in: query
        description: The data source being used for monitoring.
        required: true
        schema:
          type: string
          example: twitter
        examples:
          default:
            value: twitter
      responses:
        '200':
          description: Return all filters for a specific data_source Page
          content:
            example_0:
              examples:
                example_0:
                  value:
                    data:
                      pages_name:
                      - engagements
        '401':
          description: missing_API_key
          content:
            example_0:
              examples:
                example_0:
                  value:
                    message: No API key found in request
            example_1:
              examples:
                example_0:
                  value:
                    message: Invalid authentication credentials
        '403':
          description: not_authorized
        '404':
          description: Page Not Found or Monitor Not Found
          content:
            example_0:
              examples:
                example_0:
                  value:
                    error:
                      status: 404
                      detail: Couldn't find MonitorModel with 'id'=12354443
        '429':
          description: too_many_requests
          content:
            example_0:
              examples:
                example_0:
                  value:
                    message: API rate limit exceeded
        '500':
          description: internal_server_error
        '503':
          description: service_unavailable
        '504':
          description: request_timeout
      servers:
      - url: https://api.lucidya.com
        description: Production
x-internal: false