Market Brew Tasks API
Optimization tasks generated by individual Ranking Sensor calibration snapshots.
Optimization tasks generated by individual Ranking Sensor calibration snapshots.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/marketbrew-ai:marketbrew-ai-tasks-api"
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.
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: 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