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

# List page follower filter values

> The values a page follower signal's provider-side filters accept: countries, job_titles, departments and seniority_levels. Closed vocabularies enforced by the provider (country NAMES rather than ISO codes, the provider's own job-title and department labels), so a value invented from your own wording is refused at save time. These filters are applied during the scrape, so they decide who is read and paid for, not only who is kept. Pass `axis` for one list (job_titles holds several hundred values), omit it for all four.



## OpenAPI

````yaml /reference/openapi.yaml get /v2/page-follower-signals/filter-values
openapi: 3.1.0
info:
  title: Tamtam Public API
  version: 2.0.0
servers:
  - url: https://api.tamtam.ai/api
security: []
paths:
  /v2/page-follower-signals/filter-values:
    get:
      tags:
        - Signals
      summary: List page follower filter values
      description: >-
        The values a page follower signal's provider-side filters accept:
        countries, job_titles, departments and seniority_levels. Closed
        vocabularies enforced by the provider (country NAMES rather than ISO
        codes, the provider's own job-title and department labels), so a value
        invented from your own wording is refused at save time. These filters
        are applied during the scrape, so they decide who is read and paid for,
        not only who is kept. Pass `axis` for one list (job_titles holds several
        hundred values), omit it for all four.
      operationId: list-page-follower-filter-values
      parameters:
        - description: Which vocabulary to return. Omit for all four.
          explode: false
          in: query
          name: axis
          schema:
            description: Which vocabulary to return. Omit for all four.
            enum:
              - countries
              - job_titles
              - departments
              - seniority_levels
            type: string
        - description: >-
            Optional case-insensitive substring filter, useful for narrowing
            job_titles.
          explode: false
          in: query
          name: contains
          schema:
            description: >-
              Optional case-insensitive substring filter, useful for narrowing
              job_titles.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPageFollowerFilterValuesOutputBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      security:
        - apikeyAuth: []
        - bearerAuth: []
components:
  schemas:
    ListPageFollowerFilterValuesOutputBody:
      additionalProperties: false
      properties:
        vocabularies:
          additionalProperties:
            items:
              type: string
            type:
              - array
              - 'null'
          description: >-
            The accepted values per axis. Country NAMES rather than ISO codes,
            and the provider's own job-title and department labels.
          type: object
      required:
        - vocabularies
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    apikeyAuth:
      description: Account API key passed in the Authorization header
      in: header
      name: Authorization
      type: apiKey
    bearerAuth:
      description: Bearer JWT obtained via the OAuth 2.1 authorization flow
      scheme: bearer
      type: http

````