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/docrocket-ai:docrocket-ai-brand-from-url-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: DocRocket Brand From Url API
  description: 'DocRocket surfaces: (1) **HTTPS JSON API** at `api.docrocket.ai/v1` — POST a single JSON envelope with `action` plus optional `account_id`, `user_id`, and a `body` object for action-specific fields. Use an Auth0 access token or DocRocket API key JWT in `Authorization: Bearer`. (2) **MCP-aligned HTTP paths** on the MCP gateway for high-level document flows. (3) **Direct Lambda invoke** with the same envelope shape for batch/tool integrations.'
  version: 1.0.0
  contact:
    email: hello@docrocket.ai
    url: https://docrocket.ai
  x-mcp-endpoint: https://mcp.docrocket.ai/v1/mcp-tools/docrocket-control/mcp
servers:
- url: https://api.docrocket.ai/v1
  description: Production HTTPS API (Auth0 or API key JWT)
- url: https://mcp.docrocket.ai/v1/mcp-tools/docrocket-control
  description: DocRocket MCP HTTP gateway (OAuth / MCP client flows)
security:
- oauth2: []
tags:
- name: Brand From Url
paths:
  /brand-from-url:
    post:
      servers:
      - url: https://mcp.docrocket.ai/v1/mcp-tools/docrocket-control
        description: MCP gateway base URL for these paths
      operationId: docrocket_brand_from_url
      summary: Extract brand from URL
      description: 'Crawls a customer''s website and automatically extracts brand identity: logo, primary and secondary colors, and typography. Creates a reusable brand profile. Call this once per customer — the brand ID can be reused for unlimited document generation.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - url
              properties:
                url:
                  type: string
                  format: uri
                  description: The customer's public website URL
                  example: https://acme.com
                name:
                  type: string
                  description: Optional display name for this brand. Defaults to the site's detected company name.
      responses:
        '200':
          description: Brand successfully extracted
          content:
            application/json:
              schema:
                type: object
                properties:
                  brand_id:
                    type: string
                  name:
                    type: string
                  logo_url:
                    type: string
                  colors:
                    type: object
                    properties:
                      primary:
                        type: string
                      secondary:
                        type: string
                      accent:
                        type: string
                  fonts:
                    type: object
                    properties:
                      heading:
                        type: string
                      body:
                        type: string
      tags:
      - Brand From Url
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Auth0 access token (DocRocket SPA audience) or DocRocket-issued API key JWT.
    oauth2:
      type: oauth2
      description: OAuth 2.0 via DocRocket account. No API keys needed.
      flows:
        authorizationCode:
          authorizationUrl: https://app.docrocket.ai/oauth/authorize
          tokenUrl: https://app.docrocket.ai/oauth/token
          scopes:
            documents:write: Generate documents
            documents:read: Read documents
            brands:write: Create and update brands
            brands:read: Read brands
            templates:read: Read templates