Market Brew Search API
Semantic retrieval over a customer's crawled site content, returning relevant pages, snippets, and ranking signals.
Semantic retrieval over a customer's crawled site content, returning relevant pages, snippets, and ranking signals.
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-search-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 Search API
description: REST API reference for Market Brew platform data, content intelligence, and customer workspace endpoints.
version: '1.0'
servers:
- url: /
tags:
- name: Search
description: Semantic retrieval over a customer's crawled site content, returning relevant pages, snippets, and ranking signals.
paths:
/api/v1/search/metrics:
get:
tags:
- Search
summary: Get Search API configuration usage metrics
parameters:
- name: crewIds
in: query
schema:
type: string
- name: customerId
in: query
schema:
format: int32
type: integer
- name: endDate
in: query
schema:
type: string
- name: serverHost
in: query
schema:
type: string
- name: startDate
in: query
schema:
type: string
- name: websiteId
in: query
schema:
format: int64
type: integer
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SearchMetrics'
security:
- API-Key: []
operationId: getApiV1SearchMetrics
x-operation-id-source: derived
/api/v1/search/{searchWidgetId}/history:
get:
tags:
- Search
summary: List Search Widget query history
description: Returns recent query history for the selected Search Widget.
parameters:
- name: searchWidgetId
in: path
required: true
schema:
format: int64
type: integer
- name: websiteHost
in: query
required: false
schema:
type: string
- name: X-Search-Session-Token
in: header
description: Search Widget browser-session credential required for public history access.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/SearchHistorySummary'
security:
- API-Key: []
operationId: getApiV1SearchBySearchWidgetIdHistory
x-operation-id-source: derived
/api/v1/search/{searchWidgetId}/history/{searchHistoryId}:
get:
tags:
- Search
summary: Get Search Widget query history detail
description: Returns one Search Widget query history row.
parameters:
- name: searchHistoryId
in: path
required: true
schema:
format: int64
type: integer
- name: searchWidgetId
in: path
required: true
schema:
format: int64
type: integer
- name: X-Search-Session-Token
in: header
description: Search Widget browser-session credential required for public history access.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SearchHistoryDTO'
security:
- API-Key: []
operationId: getApiV1SearchBySearchWidgetIdHistoryBySearchHistoryId
x-operation-id-source: derived
/api/v1/search/{searchWidgetId}/query:
post:
tags:
- Search
summary: Search site content
description: Returns semantically relevant pages and snippets for the selected Search widget.
parameters:
- name: searchWidgetId
in: path
required: true
schema:
format: int64
type: integer
- name: websiteHost
in: query
required: false
schema:
type: string
- name: X-Search-Session-Token
in: header
description: Search Widget browser-session credential used for history ownership and session throttling.
required: false
schema:
type: string
requestBody:
description: Search query request.
content:
application/json:
schema:
$ref: '#/components/schemas/SearchRequest'
examples:
Search request:
value:
query: How do I improve AI visibility?
inferLanguage: true
offset: 0
limit: 10
required: true
responses:
'200':
description: Search results with reference URLs and snippets
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
examples:
Search response:
value:
query: How do I improve AI visibility?
totalResults: 2
results:
- url: https://www.example.com/ai-search-visibility
title: AI Search Visibility Guide
snippet: Improve AI visibility by aligning authoritative content with the questions buyers ask...
relevanceScore: 0.91
pageFit: 0.86
weighted: 0.7826
'402':
description: No active license or remaining entitlements for the Search Widget on this site
'500':
description: Internal error processing the search request
security:
- API-Key: []
operationId: postApiV1SearchBySearchWidgetIdQuery
x-operation-id-source: derived
/api/v1/search/{searchWidgetId}/search:
get:
tags:
- Search
summary: Get Search Widget session state
description: Returns readiness flags and recent query history for the selected Search Widget.
parameters:
- name: searchWidgetId
in: path
required: true
schema:
format: int64
type: integer
- name: websiteHost
in: query
required: false
schema:
type: string
- name: X-Search-Session-Token
in: header
description: Previously issued Search Widget browser-session credential.
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SearchSessionResponse'
security:
- API-Key: []
operationId: getApiV1SearchBySearchWidgetIdSearch
x-operation-id-source: derived
components:
schemas:
SearchSessionResponse:
type: object
properties:
sessionToken:
type: string
embeddingsReady:
type: boolean
searchHistory:
type: array
items:
$ref: '#/components/schemas/SearchHistorySummary'
SearchHistorySummary:
type: object
properties:
searchHistoryId:
format: int64
type: integer
query:
type: string
createdAt:
format: date-time
type: string
example: 2022-03-10 12:15:50
totalResults:
format: int32
type: integer
hasContentGap:
type: boolean
SearchRequest:
type: object
properties:
query:
type: string
inferLanguage:
type: boolean
locale:
type: object
offset:
format: int32
type: integer
limit:
format: int32
type: integer
SearchHistoryDTO:
type: object
properties:
searchHistoryId:
format: int64
type: integer
query:
type: string
createdAt:
format: date-time
type: string
example: 2022-03-10 12:15:50
totalResults:
format: int32
type: integer
hasContentGap:
type: boolean
websiteHost:
type: string
locale:
type: object
inferLanguage:
type: boolean
offset:
format: int32
type: integer
limit:
format: int32
type: integer
maxPageFit:
format: double
type: number
contentGap:
format: double
type: number
contentGapThreshold:
format: double
type: number
accessChannel:
type: string
actor:
type: string
SearchResponse:
type: object
properties:
query:
type: string
results:
type: array
items:
$ref: '#/components/schemas/SearchResult'
totalResults:
format: int32
type: integer
metrics:
type: object
additionalProperties:
type: object
SearchMetrics:
type: object
properties:
widgets:
format: int64
type: integer
SearchResult:
type: object
properties:
url:
type: string
title:
type: string
snippet:
type: string
relevanceScore:
format: double
type: number
pageFit:
format: double
type: number
weighted:
format: double
type: number
catalogWebpageId:
format: int64
type: integer
offset:
format: int32
type: integer
length:
format: int32
type: integer
sourceHealth:
type: string
lastSuccessfulCrawlAt:
format: date-time
type: string
example: 2022-03-10 12:15:50
lastAttemptAt:
format: date-time
type: string
example: 2022-03-10 12:15:50
crawlWarning:
type: string
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