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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/bisibility-com:bisibility-com-signals-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Bisibility Com Signals API
version: 1.0.0
description: 'Operations tagged signals across 2 of this provider''s published API definitions: eu.bisibility.com_v1_openapi.json, bisibility-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /api/v1
tags:
- name: Signals
description: Ingest and list project signals.
x-group: Signals
paths:
/projects/{project_id}/signals:
get:
operationId: listSignals
parameters:
- description: API contract version requested by the client. Omit this header to use the current backward-compatible behavior.
in: header
name: Bisibility-API-Version
required: false
schema:
enum:
- v1
type: string
x-bisibility-enum: open
x-bisibility-name: ApiVersion
- in: path
name: project_id
required: true
schema:
example: prj_a00000000000000000000000
pattern: ^prj_[a-z][a-z0-9]{23}$
type: string
description: Public project ID; membership and token scope are enforced.
x-bisibility-public-id: prj
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Cursor'
- description: Filter by signal source.
in: query
name: source
schema:
enum:
- rank_tracker
- search_analytics
- url_inspection
- sitemap
- deploy
- cms
- search_engine_status
- manual
- api
type: string
- description: Filter by signal type.
in: query
name: type
schema:
type: string
- description: Return signals at or after this ISO-8601 date-time.
in: query
name: from
schema:
format: date-time
type: string
- description: Return signals at or before this ISO-8601 date-time.
in: query
name: to
schema:
format: date-time
type: string
- $ref: '#/components/parameters/SourceHeader'
responses:
'200':
content:
application/json:
schema:
properties:
data:
items:
$ref: '#/components/schemas/Signal'
type: array
meta:
properties:
next_cursor:
type:
- string
- 'null'
required:
- next_cursor
type: object
x-bisibility-name: PageMeta
required:
- data
- meta
type: object
x-bisibility-name: SignalPage
description: JSON response
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Bad request
'401':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Unauthorized
'403':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Forbidden
'404':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Not found
'409':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Unsupported API version
'429':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Rate limited
security:
- ProjectApiKey: []
- PersonalAccessToken: []
- AppOAuth:
- api:read
summary: List project signals
tags:
- Signals
x-bisibility-cost:
kind: free
servers:
- url: /api/v1
/signals:
post:
operationId: createSignal
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SignalCreate'
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/Signal'
description: Signal ingested
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Bad request
'401':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Unauthorized
'403':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Forbidden
'404':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Not found
'409':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Unsupported API version
'423':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Project read-only
'429':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
description: Rate limited
security:
- ProjectApiKey: []
- PersonalAccessToken: []
- AppOAuth:
- api:write
summary: Ingest a project signal
parameters:
- description: API contract version requested by the client. Omit this header to use the current backward-compatible behavior.
in: header
name: Bisibility-API-Version
required: false
schema:
enum:
- v1
type: string
x-bisibility-enum: open
x-bisibility-name: ApiVersion
- $ref: '#/components/parameters/ProjectHeader'
- $ref: '#/components/parameters/ProjectQuery'
- $ref: '#/components/parameters/SourceHeader'
tags:
- Signals
x-bisibility-cost:
kind: free
servers:
- url: /api/v1
components:
parameters:
SourceHeader:
description: 'Declares the client that produced the request for usage reporting: sdk, cli or mcp. Optional; any other value counts as api. It never changes authentication or which budget applies (every bearer-authenticated request counts against the API, MCP and SDK budget).'
in: header
name: X-Bisibility-Source
required: false
schema:
enum:
- sdk
- cli
- mcp
type: string
x-bisibility-enum: open
x-bisibility-name: RequestSource
ProjectQuery:
description: 'Query-parameter equivalent of the X-Bisibility-Project header for personal-access-token project selection. Optional. Selection precedence is: {project_id} path parameter, X-Bisibility-Project header, project query parameter, then inference when the PAT owner belongs to exactly one project.'
in: query
name: project
required: false
schema:
type: string
Cursor:
description: Opaque v3 cursor returned as meta.next_cursor from the previous page.
in: query
name: cursor
schema:
type: string
ProjectHeader:
description: 'Project public ID (prj_...) targeted by this personal-access-token request. Optional. Selection precedence is: {project_id} path parameter, X-Bisibility-Project header, project query parameter, then inference when the PAT owner belongs to exactly one project. Project API keys and paths that already carry a project ID ignore it.'
in: header
name: X-Bisibility-Project
required: false
schema:
type: string
Limit:
description: Maximum items to return. Defaults to 50.
in: query
name: limit
schema:
default: 50
maximum: 200
minimum: 1
type: integer
schemas:
SignalCreate:
properties:
happened_at:
description: ISO-8601 date-time when the signal happened. Defaults to now.
format: date-time
type: string
keyword_id:
example: kw_a00000000000000000000000
pattern: ^kw_[a-z][a-z0-9]{23}$
type: string
x-bisibility-public-id: kw
payload:
additionalProperties: true
description: JSON object payload. Ingestion rejects serialized payloads above 8KB.
type: object
severity:
default: info
enum:
- info
- warning
- critical
type: string
source:
enum:
- deploy
- cms
- api
type: string
type:
example: deploy.completed
pattern: ^[a-z_]+\.[a-z_]+$
type: string
url:
format: uri
type: string
required:
- source
- type
type: object
Signal:
properties:
created_at:
format: date-time
type: string
happened_at:
format: date-time
type: string
id:
example: sig_a00000000000000000000000
pattern: ^sig_[a-z][a-z0-9]{23}$
type: string
x-bisibility-public-id: sig
keyword_id:
example: kw_a00000000000000000000000
pattern: ^kw_[a-z][a-z0-9]{23}$
type:
- string
- 'null'
x-bisibility-public-id: kw
payload:
additionalProperties: true
description: JSON object payload. Ingestion rejects serialized payloads above 8KB.
type:
- object
- 'null'
project_id:
example: prj_a00000000000000000000000
pattern: ^prj_[a-z][a-z0-9]{23}$
type: string
x-bisibility-public-id: prj
public_id:
example: sig_a00000000000000000000000
pattern: ^sig_[a-z][a-z0-9]{23}$
type: string
x-bisibility-public-id: sig
severity:
enum:
- info
- warning
- critical
type: string
source:
enum:
- rank_tracker
- search_analytics
- url_inspection
- sitemap
- deploy
- cms
- search_engine_status
- manual
- api
type: string
type:
example: deploy.completed
pattern: ^[a-z_]+\.[a-z_]+$
type: string
url:
format: uri
type:
- string
- 'null'
required:
- id
- public_id
- project_id
- keyword_id
- source
- type
- severity
- url
- payload
- happened_at
- created_at
type: object
Problem:
properties:
detail:
type: string
details:
additionalProperties: true
type: object
docs_url:
type: string
errors: {}
instance:
type: string
status:
type: integer
title:
type: string
type:
type: string
required:
- type
- title
- status
- detail
- instance
- docs_url
type: object
securitySchemes:
PersonalAccessToken:
bearerFormat: bsb_pat_live_...
description: Personal access token for account routes and projects visible to the authenticated user.
scheme: bearer
type: http
ProjectApiKey:
bearerFormat: bsb_key_live_...
description: Project-scoped API key. It cannot access account routes or create additional projects.
scheme: bearer
type: http
MigrationToken:
bearerFormat: mig_...
description: 'Migration token sent as `Authorization: Bearer mig_...`.'
scheme: bearer
type: http
AppOAuth:
description: 'OAuth 2.0 for the first-party Bisibility apps only; other clients cannot obtain these scopes. Use the authorization code flow with PKCE (S256) and no client secret, and do not send a `resource` parameter: `/api/v1` accepts only the opaque access tokens issued without one. Access tokens expire after 15 minutes. Refresh tokens rotate on every use, and replaying a used refresh token revokes the whole grant. To sign out, POST the refresh token with `token_type_hint=refresh_token` and the `client_id` to `/api/auth/oauth2/revoke`. Account deletion additionally requires a sign-in from the last 10 minutes (authorize again with `prompt=login`); otherwise it fails with 403 and `details.code` `reauthentication_required`. Admin operations are not available to app tokens.'
flows:
authorizationCode:
authorizationUrl: /api/auth/oauth2/authorize
refreshUrl: /api/auth/oauth2/token
scopes:
api:read: Read the account and projects visible to the user.
api:write: Read, and change projects within the user's role. Implies api:read.
tokenUrl: /api/auth/oauth2/token
type: oauth2
x-refined-from:
- eu.bisibility.com_v1_openapi.json
- bisibility-com-openapi.json