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

# Get list of presets, filtered by parameters

> Returns active, public presets (active=1, private=0), ordered by title ascending. Each element is Presets::apiData(). Pagination: limit is capped at 50; page defaults to 1.



## OpenAPI

````yaml https://api.boosterberg.com-beta.com/v1/doc/api-json post /presets/browse
openapi: 3.0.0
info:
  title: Boosterberg API
  description: REST API For Boosterberg user-facing application
  contact:
    name: Miloslav Kona
    email: mkona@bykd.com
  version: '1.0'
servers:
  - url: https://api.boosterberg.com-beta.com/v1
    description: dev server
  - url: https://auto.boost.api/v1
    description: local
  - url: https://api.boosterberg.com/v1
    description: production
security: []
tags:
  - name: Posts
    description: Post lifecycle and evaluation data across all campaigns
paths:
  /presets/browse:
    post:
      summary: Get list of presets, filtered by parameters
      description: >-
        Returns active, public presets (active=1, private=0), ordered by title
        ascending. Each element is Presets::apiData(). Pagination: limit is
        capped at 50; page defaults to 1.
      operationId: c7a730aef7f8e0dd55ece80110276989
      requestBody:
        description: All fields optional. Filters are combined with AND.
        required: true
        content:
          application/json:
            schema:
              properties:
                page:
                  description: 1-based page index for offset calculation
                  type: integer
                  default: 1
                  minimum: 1
                limit:
                  description: Page size; values above 50 are treated as 50
                  type: integer
                  default: 50
                  maximum: 50
                  minimum: 1
                goal:
                  description: >-
                    Exact match on presets.campaign_objective (Marketing API
                    objective code, e.g. OUTCOME_TRAFFIC, OUTCOME_LEADS, or
                    legacy values still stored in DB)
                  type: string
                  example: OUTCOME_TRAFFIC
                vertical:
                  description: >-
                    SQL LIKE filter on presets.vertical (comma-separated slug
                    list in DB); match is literal substring
                  type: string
                  example: finance
                agency_id:
                  description: Only presets where master_agency_id equals this value
                  type: integer
                  example: 2345
                partner_id:
                  description: 'Alias filter: same as agency_id (master_agency_id match)'
                  type: integer
                  example: 2345
                preset_name:
                  description: Case-sensitive prefix match on title (LIKE 'value%')
                  type: string
                  example: Travel
                excluded_preset_id:
                  description: Exclude this preset id from results
                  type: integer
                location:
                  description: >-
                    JSON_CONTAINS on audience_targeting.geo_locations for
                    country, city, or region entries
                  properties:
                    type:
                      description: >-
                        Default branch uses regions when type is not country or
                        city
                      type: string
                      enum:
                        - country
                        - city
                        - region
                    value:
                      description: >-
                        Country code (type=country), or geo key
                        (type=city/region)
                      type: string
                    label:
                      description: >-
                        Display name; used when building city/region JSON
                        payload
                      type: string
                  type: object
              type: object
      responses:
        '200':
          description: >-
            Array of preset payloads (see #/components/schemas/Preset); browse
            does not include number_of_purchases
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Preset'
      security: []
components:
  schemas:
    Preset:
      description: Serialized via Presets::apiData() for API list/detail responses.
      properties:
        id:
          type: integer
          example: 1
        title:
          nullable: true
          type: string
          example: Travel Pack
        image:
          nullable: true
          description: Absolute URL of the preset image; null if none
          type: string
          format: uri
        campaign_objective:
          description: >-
            Localized human-readable objective label from
            BoostedPages::objectivesList()
          type: string
        vertical:
          description: >-
            Display labels per stored vertical slug; entry may be null if the
            slug has no mapping
          type: array
          items:
            type: string
            nullable: true
        price:
          description: Chargeable monthly price including boosterberg_fixed_fee
          type: number
          format: float
          example: '19.99'
        original_price:
          description: Original price including boosterberg_fixed_fee
          type: number
          format: float
          example: '29.99'
        version:
          type: number
          format: float
          example: 1
        private:
          type: boolean
        platform:
          type: string
          enum:
            - all
            - facebook
            - instagram
          example: all
        audience_targeting:
          type: string
          nullable: true
        location_json:
          nullable: true
          description: JSON string of location/geographic targeting payload
          type: string
        description:
          type: string
          nullable: true
        hashtags:
          description: >-
            Keywords from boosting conditions when advanced_settings is enabled;
            otherwise empty
          type: array
          items:
            type: string
        reach:
          description: >-
            [] when advanced_settings is off; integer percentage when set; null
            when advanced_settings is on but no matching condition row
          oneOf:
            - type: array
              items: {}
            - description: organic_fans_percentage from boosting conditions
              type: integer
              nullable: true
        allowed_options:
          description: >-
            Subset of preset_allowed_options.option values enabled for this
            preset (see PresetAllowedOptions constants / getAll())
          type: array
          items:
            type: string
            enum:
              - location
              - age
              - gender
              - tags
              - advanced_settings
              - cta
        rating:
          description: >-
            Average preset review rating rounded to nearest whole number; 0 when
            there are no reviews
          type: number
          example: 4
        agency:
          $ref: '#/components/schemas/Agency'
      type: object
    Agency:
      properties:
        username:
          type: string
          example: Lounge Lizard Worldwide
        description:
          type: string
        about:
          type: string
        image:
          type: string
          format: uri
        website:
          type: string
          format: uri
        locations:
          type: string
        services:
          type: array
          items:
            type: string
            example:
              - E-commerce
              - Branding
        industries:
          type: array
          items:
            type: string
            example:
              - Retail
              - Healthcare
        gps:
          type: string
          example: 40.730610,-73.935242
        employess:
          type: string
          example: 11-50
        coordinates:
          type: string
          example: 48.148598,17.107748
      type: object

````