Market Brew Tasks API

Optimization tasks generated by individual Ranking Sensor calibration snapshots.

GitHub OpenAPI

Operations 5

GET /api/v1/tasks List current Ranking Sensor tasks #
GET /api/v1/tasks/history List historical Ranking Sensor task progress #
GET /api/v1/tasks/{taskId} Get an individual Ranking Sensor task #
GET /api/v1/tasks/{taskId}/children List child tasks for an individual task #
GET /api/v1/tasks/{taskId}/history Get one task's calculation history by calibration period #

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/marketbrew-ai:marketbrew-ai-tasks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

marketbrew-ai-tasks-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Market Brew API Documentation Tasks API
  description: REST API reference for Market Brew platform data, content intelligence, and customer workspace endpoints.
  version: '1.0'
servers:
- url: /
tags:
- name: Tasks
  description: Optimization tasks generated by individual Ranking Sensor calibration snapshots.
paths:
  /api/v1/tasks:
    get:
      tags:
      - Tasks
      summary: List current Ranking Sensor tasks
      description: Returns current, non-archived top-level task states from Ranking Sensor calibration snapshots. Use the children endpoint to retrieve implementation-level child tasks.
      parameters:
      - name: boostFactorId
        in: query
        schema:
          format: int32
          type: integer
      - name: endDate
        in: query
        schema:
          type: string
      - name: offset
        in: query
        schema:
          format: int32
          type: integer
      - name: pageSize
        in: query
        schema:
          format: int32
          type: integer
      - name: rankingSensorId
        in: query
        schema:
          format: int32
          type: integer
      - name: serverHost
        in: query
        schema:
          type: string
      - name: snapshotId
        in: query
        schema:
          format: int32
          type: integer
      - name: sortBy
        in: query
        schema:
          type: string
      - name: sortDir
        in: query
        schema:
          type: string
      - name: startDate
        in: query
        schema:
          type: string
      - name: taskTitle
        in: query
        schema:
          type: string
      - name: webpageId
        in: query
        schema:
          format: int64
          type: integer
      - name: websiteId
        in: query
        schema:
          format: int64
          type: integer
      - name: workspaceId
        in: query
        schema:
          format: int32
          type: integer
      responses:
        '200':
          description: Current individual Ranking Sensor task rows.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskListResponse'
      security:
      - API-Key: []
      operationId: getApiV1Tasks
      x-operation-id-source: derived
  /api/v1/tasks/history:
    get:
      tags:
      - Tasks
      summary: List historical Ranking Sensor task progress
      description: Returns final top-level task states from archived Ranking Sensor calibration snapshots. Use the children endpoint to retrieve implementation-level child tasks.
      parameters:
      - name: boostFactorId
        in: query
        schema:
          format: int32
          type: integer
      - name: endDate
        in: query
        schema:
          type: string
      - name: offset
        in: query
        schema:
          format: int32
          type: integer
      - name: pageSize
        in: query
        schema:
          format: int32
          type: integer
      - name: rankingSensorId
        in: query
        schema:
          format: int32
          type: integer
      - name: serverHost
        in: query
        schema:
          type: string
      - name: snapshotId
        in: query
        schema:
          format: int32
          type: integer
      - name: sortBy
        in: query
        schema:
          type: string
      - name: sortDir
        in: query
        schema:
          type: string
      - name: startDate
        in: query
        schema:
          type: string
      - name: taskTitle
        in: query
        schema:
          type: string
      - name: webpageId
        in: query
        schema:
          format: int64
          type: integer
      - name: websiteId
        in: query
        schema:
          format: int64
          type: integer
      - name: workspaceId
        in: query
        schema:
          format: int32
          type: integer
      responses:
        '200':
          description: Historical Ranking Sensor task rows, newest snapshots first by default.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskListResponse'
              examples:
                Task history response:
                  value:
                    tasks:
                    - taskId: 9012
                      taskTitle: Improve answer extraction on pricing pages
                      optimizationScore: 48.5
                      previousCompletionPercentage: 20
                      completionPercentage: 65
                      progressDelta: 45
                      archived: true
                      snapshotId: 1234
                      snapshotDate: 2026-06-30 14:20:00+00:00
                      rankingSensorId: 456
                      rankingSensorName: US Desktop
                    total: 1
                    offset: 0
                    pageSize: 50
                    hasMore: false
      security:
      - API-Key: []
      operationId: getApiV1TasksHistory
      x-operation-id-source: derived
  /api/v1/tasks/{taskId}:
    get:
      tags:
      - Tasks
      summary: Get an individual Ranking Sensor task
      description: Returns one current or archived task when it is visible to the authenticated customer.
      parameters:
      - name: taskId
        in: path
        required: true
        schema:
          format: int32
          type: integer
      responses:
        '200':
          description: The requested individual task.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskDTO'
        '404':
          description: The task does not exist or is outside the authenticated customer scope.
      security:
      - API-Key: []
      operationId: getApiV1TasksByTaskId
      x-operation-id-source: derived
  /api/v1/tasks/{taskId}/children:
    get:
      tags:
      - Tasks
      summary: List child tasks for an individual task
      description: Returns the child implementation tasks for a visible current or archived parent task.
      parameters:
      - name: taskId
        in: path
        required: true
        schema:
          format: int32
          type: integer
      - name: boostFactorId
        in: query
        schema:
          format: int32
          type: integer
      - name: endDate
        in: query
        schema:
          type: string
      - name: offset
        in: query
        schema:
          format: int32
          type: integer
      - name: pageSize
        in: query
        schema:
          format: int32
          type: integer
      - name: rankingSensorId
        in: query
        schema:
          format: int32
          type: integer
      - name: serverHost
        in: query
        schema:
          type: string
      - name: snapshotId
        in: query
        schema:
          format: int32
          type: integer
      - name: sortBy
        in: query
        schema:
          type: string
      - name: sortDir
        in: query
        schema:
          type: string
      - name: startDate
        in: query
        schema:
          type: string
      - name: taskTitle
        in: query
        schema:
          type: string
      - name: webpageId
        in: query
        schema:
          format: int64
          type: integer
      - name: websiteId
        in: query
        schema:
          format: int64
          type: integer
      - name: workspaceId
        in: query
        schema:
          format: int32
          type: integer
      responses:
        '200':
          description: A paginated collection of child task rows.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskListResponse'
        '404':
          description: The parent task does not exist or is outside the authenticated customer scope.
      security:
      - API-Key: []
      operationId: getApiV1TasksByTaskIdChildren
      x-operation-id-source: derived
  /api/v1/tasks/{taskId}/history:
    get:
      tags:
      - Tasks
      summary: Get one task's calculation history by calibration period
      description: Returns immutable task progress observed after each Ranking Sensor calculation, grouped under the calibration that reset and governed that task period.
      parameters:
      - name: taskId
        in: path
        required: true
        schema:
          format: int32
          type: integer
      - name: boostFactorId
        in: query
        schema:
          format: int32
          type: integer
      - name: endDate
        in: query
        schema:
          type: string
      - name: offset
        in: query
        schema:
          format: int32
          type: integer
      - name: pageSize
        in: query
        schema:
          format: int32
          type: integer
      - name: rankingSensorId
        in: query
        schema:
          format: int32
          type: integer
      - name: serverHost
        in: query
        schema:
          type: string
      - name: snapshotId
        in: query
        schema:
          format: int32
          type: integer
      - name: sortBy
        in: query
        schema:
          type: string
      - name: sortDir
        in: query
        schema:
          type: string
      - name: startDate
        in: query
        schema:
          type: string
      - name: taskTitle
        in: query
        schema:
          type: string
      - name: webpageId
        in: query
        schema:
          format: int64
          type: integer
      - name: websiteId
        in: query
        schema:
          format: int64
          type: integer
      - name: workspaceId
        in: query
        schema:
          format: int32
          type: integer
      responses:
        '200':
          description: Task calculation history grouped by calibration period.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskCalibrationHistoryResponse'
        '404':
          description: The source task does not exist or is outside the authenticated customer scope.
      security:
      - API-Key: []
      operationId: getApiV1TasksByTaskIdHistory
      x-operation-id-source: derived
components:
  schemas:
    TaskLineageMatchStrategy:
      enum:
      - STABLE_IDENTIFIERS
      - TITLE_FALLBACK
      type: string
    TaskHistoryCompleteness:
      enum:
      - FULL
      - LEGACY_DERIVED
      - PARTIAL
      type: string
    TaskDTO:
      type: object
      properties:
        taskId:
          format: int32
          type: integer
        taskKey:
          type: string
        parentTaskId:
          format: int32
          type: integer
        taskTitle:
          type: string
        summary:
          type: string
        description:
          type: string
        taskType:
          format: int32
          type: integer
        taskTypeLabel:
          type: string
        optimizationScore:
          type: number
        hoursRequired:
          type: number
        previousCompletionPercentage:
          format: int32
          type: integer
        completionPercentage:
          format: int32
          type: integer
        progressDelta:
          format: int32
          type: integer
        status:
          $ref: '#/components/schemas/TaskStatus'
        childCount:
          format: int32
          type: integer
        archived:
          type: boolean
        snapshotId:
          format: int32
          type: integer
        snapshotDate:
          format: date-time
          type: string
          example: 2022-03-10 16:15:50+00:00
        rankingSensorId:
          format: int32
          type: integer
        rankingSensorName:
          type: string
        correlationKeyword:
          type: string
        websiteId:
          format: int64
          type: integer
        webpageId:
          format: int64
          type: integer
        boostFactorId:
          format: int32
          type: integer
        serverHost:
          type: string
        pagePath:
          type: string
    TaskCalibrationHistoryResponse:
      type: object
      properties:
        taskKey:
          type: string
        sourceTaskId:
          format: int32
          type: integer
        matchStrategy:
          $ref: '#/components/schemas/TaskLineageMatchStrategy'
        currentTaskId:
          format: int32
          type: integer
        occurrenceCount:
          format: int64
          type: integer
        calibrationCount:
          format: int32
          type: integer
        calculationCount:
          format: int64
          type: integer
        historyAvailableFrom:
          format: date-time
          type: string
          example: 2022-03-10 16:15:50+00:00
        historyCompleteness:
          $ref: '#/components/schemas/TaskHistoryCompleteness'
        calibrationPeriods:
          type: array
          items:
            $ref: '#/components/schemas/TaskCalibrationPeriodDTO'
        firstSeenAt:
          format: date-time
          type: string
          example: 2022-03-10 16:15:50+00:00
        lastSeenAt:
          format: date-time
          type: string
          example: 2022-03-10 16:15:50+00:00
        currentProgressPercentage:
          format: int32
          type: integer
        occurrences:
          type: array
          items:
            $ref: '#/components/schemas/TaskDTO'
        offset:
          format: int32
          type: integer
        pageSize:
          format: int32
          type: integer
        hasMore:
          type: boolean
    TaskStatus:
      enum:
      - NOT_STARTED
      - IN_PROGRESS
      - COMPLETED
      type: string
    TaskCalibrationPeriodDTO:
      type: object
      properties:
        calibrationSnapshotId:
          format: int32
          type: integer
        calibrationDate:
          format: date-time
          type: string
          example: 2022-03-10 16:15:50+00:00
        current:
          type: boolean
        calculationCount:
          format: int32
          type: integer
        firstSeenAt:
          format: date-time
          type: string
          example: 2022-03-10 16:15:50+00:00
        lastSeenAt:
          format: date-time
          type: string
          example: 2022-03-10 16:15:50+00:00
        startingProgressPercentage:
          format: int32
          type: integer
        endingProgressPercentage:
          format: int32
          type: integer
        calculations:
          type: array
          items:
            $ref: '#/components/schemas/TaskDTO'
    TaskListResponse:
      type: object
      properties:
        tasks:
          type: array
          items:
            $ref: '#/components/schemas/TaskDTO'
        total:
          format: int64
          type: integer
        offset:
          format: int32
          type: integer
        pageSize:
          format: int32
          type: integer
        hasMore:
          type: boolean
  securitySchemes:
    API-Key:
      type: apiKey
      description: Market Brew API key. Send this value in the API-Key request header.
      name: API-Key
      in: header
    OAuth2-Bearer:
      type: http
      description: Short-lived Market Brew OAuth access token for the ChatGPT MCP resource.
      scheme: bearer
      bearerFormat: JWT