Bottally API

Bottally API as documented publicly: 10 operations. Contract generated from the documentation by API Evangelist (2026-11-08); not the provider's own document.

GitHub OpenAPI

Operations 10

GET /YOUR_INDEXNOW_KEY.txt Serve the IndexNow key file at the site root. #
GET /api/v1 List available endpoints. #
GET /api/v1/articles GET /api/v1/articles #
POST /api/v1/articles Publish a new article. #
DELETE /api/v1/articles/{slug} Delete a scheduled article. #
GET /api/v1/articles/{slug} Get a single article by slug. #
PATCH /api/v1/articles/{slug} Edit an existing article. #
GET /api/v1/brand Get brand information. #
GET /api/v1/keywords List researched keywords. #
GET /api/v1/visibility Get AI‑visibility summary and details. #

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/bottally:bottally-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. See our Privacy Policy and Terms.

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

OpenAPI Specification

bottally-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Bottally API
  version: '2026-11-08'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-08: 10 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Bottally has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 9
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-08'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.bottally.com/docs/api
paths:
  /YOUR_INDEXNOW_KEY.txt:
    get:
      operationId: get_YOUR_INDEXNOW_KEY_txt
      tags:
      - Your Indexnow Key
      summary: Serve the IndexNow key file at the site root.
      description: Returns status 200, content‑type text/plain, body exactly `YOUR_INDEXNOW_KEY`.
      x-source: https://www.bottally.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetYourIndexnowKeyTxtResponse'
      x-evidence:
        kind: documentation
  /api/v1:
    get:
      operationId: get_api_v1
      tags:
      - Api
      summary: List available endpoints.
      x-source: https://www.bottally.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1Response'
      x-evidence:
        kind: documentation
  /api/v1/articles:
    get:
      operationId: get_api_v1_articles
      tags:
      - Api
      summary: GET /api/v1/articles
      x-source: https://www.bottally.com/docs/api
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -H "Authorization: Bearer YOUR_BOTTALLY_API_KEY" https://www.bottally.com/api/v1/articles?limit=3 Endpoint Returns Query
          GET /api/v1/brand Who the brand is: name, domain, services, market, logo and colors, blog location, IndexNow key, counts. — GET /api/v1/articles
          Published articles, newest first — slug, title, meta title + description, excerpt, tags, cover image with alt, dates, reading tim'
    post:
      operationId: post_api_v1_articles
      tags:
      - Api
      summary: Publish a new article.
      x-source: https://www.bottally.com/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ArticlesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ArticlesResponse'
      x-evidence:
        kind: documentation
  /api/v1/articles/{slug}:
    delete:
      operationId: delete_api_v1_articles_slug
      tags:
      - Api
      summary: Delete a scheduled article.
      x-source: https://www.bottally.com/docs/api
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_api_v1_articles_slug
      tags:
      - Api
      summary: Get a single article by slug.
      x-source: https://www.bottally.com/docs/api
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ArticlesSlugResponse'
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_api_v1_articles_slug
      tags:
      - Api
      summary: Edit an existing article.
      x-source: https://www.bottally.com/docs/api
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiV1ArticlesSlugRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchApiV1ArticlesSlugResponse'
      x-evidence:
        kind: documentation
  /api/v1/brand:
    get:
      operationId: get_api_v1_brand
      tags:
      - Api
      summary: Get brand information.
      x-source: https://www.bottally.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1BrandResponse'
      x-evidence:
        kind: documentation
  /api/v1/keywords:
    get:
      operationId: get_api_v1_keywords
      tags:
      - Api
      summary: List researched keywords.
      x-source: https://www.bottally.com/docs/api
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: pool|planned|published
      - name: include_serp
        in: query
        required: false
        schema:
          type: boolean
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: ≤1000
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1KeywordsResponse'
      x-evidence:
        kind: documentation
  /api/v1/visibility:
    get:
      operationId: get_api_v1_visibility
      tags:
      - Api
      summary: Get AI‑visibility summary and details.
      x-source: https://www.bottally.com/docs/api
      parameters:
      - name: period
        in: query
        required: false
        schema:
          type: string
        description: 7d|30d|90d|1y|all
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1VisibilityResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetYourIndexnowKeyTxtResponse:
      type: object
      properties:
        body:
          type: string
          description: The IndexNow key, exactly as provided.
    GetApiV1Response:
      type: object
      properties:
        endpoints:
          type: array
          description: Array of endpoint descriptions.
    PostApiV1ArticlesRequest:
      type: object
      properties:
        title:
          type: string
        content_markdown:
          type: string
        slug:
          type: string
        excerpt:
          type: string
        tags:
          type: array
        meta_title:
          type: string
        meta_description:
          type: string
        focus_keyword:
          type: string
        faq:
          type: array
        cover_image_url:
          type: string
        cover_image_alt:
          type: string
        publish_at:
          type: string
          description: ISO‑8601; omitted = now.
      required:
      - title
      - content_markdown
    PostApiV1ArticlesResponse:
      type: object
      properties:
        article:
          type: object
          description: The created article.
    GetApiV1ArticlesSlugResponse:
      type: object
      properties:
        slug:
          type: string
        title:
          type: string
        meta_title:
          type: string
        meta_description:
          type: string
        excerpt:
          type: string
        tags:
          type: array
        cover_image_url:
          type: string
        cover_image_alt:
          type: string
        focus_keyword:
          type: string
        keyword:
          type: string
        reading_minutes:
          type: integer
        published_at:
          type: string
        updated_at:
          type: string
        url:
          type: string
        content_markdown:
          type: string
        content_html:
          type: string
        media:
          type: array
        sources:
          type: array
        faq:
          type: array
        json_ld:
          type: object
        brand:
          type: object
    PatchApiV1ArticlesSlugRequest:
      type: object
      properties:
        edits:
          type: array
          description: List of {find, replace} objects for find/replace editing.
        content_markdown:
          type: string
          description: Full rewrite of the markdown content.
        title:
          type: string
        slug:
          type: string
        excerpt:
          type: string
        tags:
          type: array
        meta_title:
          type: string
        meta_description:
          type: string
        focus_keyword:
          type: string
        faq:
          type: array
        cover_image_url:
          type: string
        cover_image_alt:
          type: string
    PatchApiV1ArticlesSlugResponse:
      type: object
      properties:
        article:
          type: object
        changed:
          type: array
        republished:
          type: boolean
    GetApiV1BrandResponse:
      type: object
      properties:
        name:
          type: string
        domain:
          type: string
        description:
          type: string
        services:
          type: array
        business_type:
          type: string
        country:
          type: string
        language:
          type: string
        logo_url:
          type: string
        brand_colors:
          type: array
        blog:
          type: object
          description: contains base_url
        counts:
          type: object
    GetApiV1KeywordsResponse:
      type: object
      properties:
        keywords:
          type: array
          description: Each with volume, difficulty, cpc, intent, priority, status, parent_keyword, our_position, serp_top.
    GetApiV1VisibilityResponse:
      type: object
      properties:
        summary:
          type: object
          description: questions, answers, mentions, mention_rate, avg_visibility_score, engines[]
        details:
          type: array
          description: Per tracked question per engine data.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Your Indexnow Key