openapi: 3.1.0
info:
  title: 'Logo API Docs: Endpoints and Examples | Worldvectorlogo'
  description: 'Reference for the Worldvectorlogo REST API: search brand logos, fetch SVG and PNG files, browse tags and sectors. Authentication, credits and code examples.'
  version: 1.0.0
servers:
  -
    url: 'https://worldvectorlogo.com'
tags:
  -
    name: Logo
    description: "\nBrowse, search, and retrieve vector logos."
  -
    name: Tag
    description: "\nExplore logos organised by tags."
  -
    name: Account
    description: "\nManage your API key and view usage statistics. Requires authentication."
  -
    name: Sector
    description: "\nBrowse logos by industry. A sector groups related tags: the Automotive\nsector holds tags like Cars and Motorcycles."
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: "Every endpoint except `GET /account/usage` also works **without a key**, limited to **10 requests per day** per IP.\n\n**To get a key**, you need a Worldvectorlogo account:\n\n1. [Sign up](https://worldvectorlogo.com/register) or [log in](https://worldvectorlogo.com/login). If you sign up with email, verify your address first.\n2. Go to [Account → API Keys](https://worldvectorlogo.com/account/api-keys) (log-in required) and create a key.\n3. Copy it immediately; it is only shown once. Lost it? Revoke it and create a new one.\n\n**Bearer header (recommended):**\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n**Query parameter** (useful when headers aren't convenient, e.g. `<img>` tags):\n```\n/api/v1/logos?api_key=YOUR_API_KEY\n```"
security:
  -
    default: []
paths:
  /api/v1/logos:
    get:
      summary: 'List all logos.'
      operationId: listAllLogos
      description: "Browse all published logos with optional sorting.\nResults are paginated with a default of 20 per page."
      parameters:
        -
          in: query
          name: page
          description: 'Page number.'
          required: false
          schema:
            type: integer
            description: 'Page number.'
            examples:
              - 1
        -
          in: query
          name: per_page
          description: 'Results per page (1-50).'
          required: false
          schema:
            type: integer
            description: 'Results per page (1-50).'
            examples:
              - 20
        -
          in: query
          name: sort
          description: 'Sort field: downloads, created.'
          required: false
          schema:
            type: string
            description: 'Sort field: downloads, created.'
            examples:
              - downloads
        -
          in: query
          name: order
          description: 'Sort direction: asc, desc.'
          required: false
          schema:
            type: string
            description: 'Sort direction: asc, desc.'
            examples:
              - desc
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 'List of logo objects.'
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - google-2015
                        name:
                          type: string
                          examples:
                            - 'Google 2015'
                        downloads:
                          type: integer
                          examples:
                            - 48230
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - technology
                              - search-engine
                        created_at:
                          type: string
                          examples:
                            - '2024-01-15T10:30:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-06-20T14:15:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/google-2015'
                    examples:
                      -
                        -
                          slug: google-2015
                          name: 'Google 2015'
                          downloads: 48230
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                          tags:
                            - technology
                            - search-engine
                          created_at: '2024-01-15T10:30:00+00:00'
                          updated_at: '2024-06-20T14:15:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web: 'https://worldvectorlogo.com/logo/google-2015'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=1'
                      last:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=100'
                      prev:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                      next:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=2'
                    description: 'Page URLs: `first`, `last`, `prev` and `next`. They keep your query parameters, so you can follow `next` as is; `prev`/`next` are null at the ends.'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        description: 'The page returned.'
                        examples:
                          - 1
                      from:
                        type: integer
                        description: 'Position of the first result on this page. Null when there are no results.'
                        examples:
                          - 1
                      last_page:
                        type: integer
                        description: 'Number of the last page.'
                        examples:
                          - 100
                      links:
                        type: array
                        description: 'A link per page, for building page buttons: `url`, `label`, `page` and `active`.'
                        items:
                          type: object
                          properties:
                            url:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            label:
                              type: string
                              examples:
                                - '&laquo; Previous'
                            page:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            active:
                              type: boolean
                              examples:
                                - false
                        examples:
                          -
                            -
                              url: null
                              label: '&laquo; Previous'
                              page: null
                              active: false
                            -
                              url: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=1'
                              label: '1'
                              page: 1
                              active: true
                            -
                              url: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=2'
                              label: '2'
                              page: 2
                              active: false
                            -
                              url: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=2'
                              label: 'Next &raquo;'
                              page: 2
                              active: false
                      path:
                        type: string
                        description: 'The endpoint URL without query parameters.'
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos'
                      per_page:
                        type: integer
                        description: 'Results per page.'
                        examples:
                          - 20
                      to:
                        type: integer
                        description: 'Position of the last result on this page. Null when there are no results.'
                        examples:
                          - 20
                      total:
                        type: integer
                        description: 'Total number of results.'
                        examples:
                          - 2000
                    description: 'Pagination details.'
                examples:
                  -
                    data:
                      -
                        slug: google-2015
                        name: 'Google 2015'
                        downloads: 48230
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          - technology
                          - search-engine
                        created_at: '2024-01-15T10:30:00+00:00'
                        updated_at: '2024-06-20T14:15:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web: 'https://worldvectorlogo.com/logo/google-2015'
                    links:
                      first: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=1'
                      last: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=100'
                      prev: null
                      next: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=2'
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 100
                      links:
                        -
                          url: null
                          label: '&laquo; Previous'
                          page: null
                          active: false
                        -
                          url: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=1'
                          label: '1'
                          page: 1
                          active: true
                        -
                          url: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=2'
                          label: '2'
                          page: 2
                          active: false
                        -
                          url: 'https://worldvectorlogo.com/api/v1/logos?per_page=20&sort=downloads&order=desc&page=2'
                          label: 'Next &raquo;'
                          page: 2
                          active: false
                      path: 'https://worldvectorlogo.com/api/v1/logos'
                      per_page: 20
                      to: 20
                      total: 2000
      tags:
        - Logo
      security: []
  /api/v1/logos/search:
    get:
      summary: 'Search logos by name.'
      operationId: searchLogosByName
      description: "Search across logo names and slugs using a query string.\nResults are ordered by download count (most popular first)."
      parameters:
        -
          in: query
          name: q
          description: 'Search query.'
          required: true
          schema:
            type: string
            description: 'Search query.'
            examples:
              - google
        -
          in: query
          name: page
          description: 'Page number.'
          required: false
          schema:
            type: integer
            description: 'Page number.'
            examples:
              - 1
        -
          in: query
          name: per_page
          description: 'Results per page (1-50).'
          required: false
          schema:
            type: integer
            description: 'Results per page (1-50).'
            examples:
              - 20
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 'List of logo objects.'
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - google-2015
                        name:
                          type: string
                          examples:
                            - 'Google 2015'
                        downloads:
                          type: integer
                          examples:
                            - 48230
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - technology
                              - search-engine
                        created_at:
                          type: string
                          examples:
                            - '2024-01-15T10:30:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-06-20T14:15:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/google-2015'
                    examples:
                      -
                        -
                          slug: google-2015
                          name: 'Google 2015'
                          downloads: 48230
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                          tags:
                            - technology
                            - search-engine
                          created_at: '2024-01-15T10:30:00+00:00'
                          updated_at: '2024-06-20T14:15:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web: 'https://worldvectorlogo.com/logo/google-2015'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos/search?q=google&per_page=20&page=1'
                      last:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos/search?q=google&per_page=20&page=1'
                      prev:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                      next:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                    description: 'Page URLs: `first`, `last`, `prev` and `next`. They keep your query parameters, so you can follow `next` as is; `prev`/`next` are null at the ends.'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        description: 'The page returned.'
                        examples:
                          - 1
                      from:
                        type: integer
                        description: 'Position of the first result on this page. Null when there are no results.'
                        examples:
                          - 1
                      last_page:
                        type: integer
                        description: 'Number of the last page.'
                        examples:
                          - 1
                      links:
                        type: array
                        description: 'A link per page, for building page buttons: `url`, `label`, `page` and `active`.'
                        items:
                          type: object
                          properties:
                            url:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            label:
                              type: string
                              examples:
                                - '&laquo; Previous'
                            page:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            active:
                              type: boolean
                              examples:
                                - false
                        examples:
                          -
                            -
                              url: null
                              label: '&laquo; Previous'
                              page: null
                              active: false
                            -
                              url: 'https://worldvectorlogo.com/api/v1/logos/search?q=google&per_page=20&page=1'
                              label: '1'
                              page: 1
                              active: true
                            -
                              url: null
                              label: 'Next &raquo;'
                              page: null
                              active: false
                      path:
                        type: string
                        description: 'The endpoint URL without query parameters.'
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/logos/search'
                      per_page:
                        type: integer
                        description: 'Results per page.'
                        examples:
                          - 20
                      to:
                        type: integer
                        description: 'Position of the last result on this page. Null when there are no results.'
                        examples:
                          - 3
                      total:
                        type: integer
                        description: 'Total number of results.'
                        examples:
                          - 3
                    description: 'Pagination details.'
                examples:
                  -
                    data:
                      -
                        slug: google-2015
                        name: 'Google 2015'
                        downloads: 48230
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          - technology
                          - search-engine
                        created_at: '2024-01-15T10:30:00+00:00'
                        updated_at: '2024-06-20T14:15:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web: 'https://worldvectorlogo.com/logo/google-2015'
                    links:
                      first: 'https://worldvectorlogo.com/api/v1/logos/search?q=google&per_page=20&page=1'
                      last: 'https://worldvectorlogo.com/api/v1/logos/search?q=google&per_page=20&page=1'
                      prev: null
                      next: null
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 1
                      links:
                        -
                          url: null
                          label: '&laquo; Previous'
                          page: null
                          active: false
                        -
                          url: 'https://worldvectorlogo.com/api/v1/logos/search?q=google&per_page=20&page=1'
                          label: '1'
                          page: 1
                          active: true
                        -
                          url: null
                          label: 'Next &raquo;'
                          page: null
                          active: false
                      path: 'https://worldvectorlogo.com/api/v1/logos/search'
                      per_page: 20
                      to: 3
                      total: 3
        422:
          description: 'Validation error'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - validation_error
                      message:
                        type: string
                        examples:
                          - 'The given data was invalid.'
                      details:
                        type: object
                        properties:
                          q:
                            type: array
                            items:
                              type: string
                            examples:
                              -
                                - 'The q field is required.'
                examples:
                  -
                    error:
                      code: validation_error
                      message: 'The given data was invalid.'
                      details:
                        q:
                          - 'The q field is required.'
      tags:
        - Logo
      security: []
  /api/v1/logos/random:
    get:
      summary: 'Get random logos.'
      operationId: getRandomLogos
      description: 'Returns a random selection of logos. Useful for showcases or demos.'
      parameters:
        -
          in: query
          name: count
          description: 'Number of logos (1-20).'
          required: false
          schema:
            type: integer
            description: 'Number of logos (1-20).'
            examples:
              - 5
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 'List of logo objects.'
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - spotify-2015
                        name:
                          type: string
                          examples:
                            - 'Spotify 2015'
                        downloads:
                          type: integer
                          examples:
                            - 12500
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/spotify-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - music
                              - streaming
                        created_at:
                          type: string
                          examples:
                            - '2024-02-10T08:00:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-05-15T12:00:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/spotify-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/spotify-2015'
                    examples:
                      -
                        -
                          slug: spotify-2015
                          name: 'Spotify 2015'
                          downloads: 12500
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/spotify-2015.svg'
                          tags:
                            - music
                            - streaming
                          created_at: '2024-02-10T08:00:00+00:00'
                          updated_at: '2024-05-15T12:00:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/spotify-2015'
                            web: 'https://worldvectorlogo.com/logo/spotify-2015'
                examples:
                  -
                    data:
                      -
                        slug: spotify-2015
                        name: 'Spotify 2015'
                        downloads: 12500
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/spotify-2015.svg'
                        tags:
                          - music
                          - streaming
                        created_at: '2024-02-10T08:00:00+00:00'
                        updated_at: '2024-05-15T12:00:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/spotify-2015'
                          web: 'https://worldvectorlogo.com/logo/spotify-2015'
      tags:
        - Logo
      security: []
  '/api/v1/logos/{slug}':
    get:
      summary: 'Get a single logo by slug.'
      operationId: getASingleLogoBySlug
      description: "Returns full details for a specific logo including tags and raw SVG content.\nThe `svg_content` field contains the full SVG markup that you can embed,\ntransform, or offer as a download in your application."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      slug:
                        type: string
                        description: 'Unique URL-safe identifier.'
                        examples:
                          - google-2015
                      name:
                        type: string
                        description: 'Display name of the logo.'
                        examples:
                          - 'Google 2015'
                      downloads:
                        type: integer
                        description: 'Total download count.'
                        examples:
                          - 48230
                      svg_url:
                        type: string
                        description: 'Direct CDN link to the SVG file.'
                        examples:
                          - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                      svg_content:
                        type: string
                        description: 'Full SVG markup. Only on this endpoint, not on lists.'
                        examples:
                          - '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 272 92">...</svg>'
                      tags:
                        type: array
                        description: 'Tag names associated with this logo.'
                        items:
                          type: string
                        examples:
                          -
                            - technology
                            - search-engine
                      created_at:
                        type: string
                        description: 'ISO 8601 timestamp. Can be null for older logos.'
                        examples:
                          - '2024-01-15T10:30:00+00:00'
                      updated_at:
                        type: string
                        description: 'ISO 8601 timestamp. Null when the logo was never edited.'
                        examples:
                          - '2024-06-20T14:15:00+00:00'
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/logo/google-2015'
                        description: 'Links to this logo: `self` (API) and `web` (website page).'
                examples:
                  -
                    data:
                      slug: google-2015
                      name: 'Google 2015'
                      downloads: 48230
                      svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                      svg_content: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 272 92">...</svg>'
                      tags:
                        - technology
                        - search-engine
                      created_at: '2024-01-15T10:30:00+00:00'
                      updated_at: '2024-06-20T14:15:00+00:00'
                      links:
                        self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                        web: 'https://worldvectorlogo.com/logo/google-2015'
        404:
          description: 'Not found'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - not_found
                      message:
                        type: string
                        examples:
                          - 'Logo not found.'
                examples:
                  -
                    error:
                      code: not_found
                      message: 'Logo not found.'
      tags:
        - Logo
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The logo slug.'
        required: true
        schema:
          type: string
          examples:
            - google-2015
  '/api/v1/logos/{slug}/png':
    get:
      summary: 'Get a logo as PNG.'
      operationId: getALogoAsPNG
      description: "Returns the raw PNG bytes, not JSON — drop the URL straight into an\n`<img>` tag or save it to a file. The image is rendered from the SVG at\nits intrinsic size and cached, so the first request for a given logo is\nslower than the rest."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: string
                examples:
                  - '<binary PNG data>'
        404:
          description: 'No such logo'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - not_found
                      message:
                        type: string
                        examples:
                          - 'Logo not found.'
                examples:
                  -
                    error:
                      code: not_found
                      message: 'Logo not found.'
        422:
          description: 'Logo has no SVG to render'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - png_unavailable
                      message:
                        type: string
                        examples:
                          - 'This logo has no SVG to render.'
                examples:
                  -
                    error:
                      code: png_unavailable
                      message: 'This logo has no SVG to render.'
      tags:
        - Logo
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The logo slug.'
        required: true
        schema:
          type: string
          examples:
            - google
  /api/v1/tags:
    get:
      summary: 'List all tags.'
      operationId: listAllTags
      description: "Returns all tags with their logo counts.\nSorted alphabetically by name."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - technology
                        name:
                          type: string
                          examples:
                            - Technology
                        logos_count:
                          type: integer
                          examples:
                            - 245
                        sector:
                          type:
                            - string
                            - 'null'
                          examples:
                            - null
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/tags/technology'
                            logos:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                    examples:
                      -
                        -
                          slug: technology
                          name: Technology
                          logos_count: 245
                          sector: null
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/tags/technology'
                            logos: 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                        -
                          slug: cars
                          name: Cars
                          logos_count: 89
                          sector:
                            slug: automotive
                            name: Automotive
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/tags/cars'
                            logos: 'https://worldvectorlogo.com/api/v1/tags/cars/logos'
                examples:
                  -
                    data:
                      -
                        slug: technology
                        name: Technology
                        logos_count: 245
                        sector: null
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/tags/technology'
                          logos: 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                      -
                        slug: cars
                        name: Cars
                        logos_count: 89
                        sector:
                          slug: automotive
                          name: Automotive
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/tags/cars'
                          logos: 'https://worldvectorlogo.com/api/v1/tags/cars/logos'
      tags:
        - Tag
      security: []
  '/api/v1/tags/{slug}':
    get:
      summary: 'Get a single tag.'
      operationId: getASingleTag
      description: 'One tag with its logo count and the sector it belongs to.'
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      slug:
                        type: string
                        description: 'Unique URL-safe identifier.'
                        examples:
                          - cars
                      name:
                        type: string
                        description: 'Display name of the tag.'
                        examples:
                          - Cars
                      logos_count:
                        type: integer
                        description: 'Number of published logos with this tag.'
                        examples:
                          - 98
                      sector:
                        type: object
                        properties:
                          slug:
                            type: string
                            examples:
                              - automotive
                          name:
                            type: string
                            examples:
                              - Automotive
                        description: 'The sector this tag belongs to (`slug`, `name`), or null.'
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/api/v1/tags/cars'
                          logos:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/api/v1/tags/cars/logos'
                        description: 'Links to this tag: `self` and `logos`.'
                examples:
                  -
                    data:
                      slug: cars
                      name: Cars
                      logos_count: 98
                      sector:
                        slug: automotive
                        name: Automotive
                      links:
                        self: 'https://worldvectorlogo.com/api/v1/tags/cars'
                        logos: 'https://worldvectorlogo.com/api/v1/tags/cars/logos'
        404:
          description: 'Tag not found'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - not_found
                      message:
                        type: string
                        examples:
                          - 'Tag not found.'
                examples:
                  -
                    error:
                      code: not_found
                      message: 'Tag not found.'
      tags:
        - Tag
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The tag slug.'
        required: true
        schema:
          type: string
          examples:
            - cars
  '/api/v1/tags/{slug}/logos':
    get:
      summary: 'Get logos for a specific tag.'
      operationId: getLogosForASpecificTag
      description: 'Returns all published logos that have the given tag.'
      parameters:
        -
          in: query
          name: page
          description: 'Page number.'
          required: false
          schema:
            type: integer
            description: 'Page number.'
            examples:
              - 1
        -
          in: query
          name: per_page
          description: 'Results per page (1-50).'
          required: false
          schema:
            type: integer
            description: 'Results per page (1-50).'
            examples:
              - 20
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 'List of logo objects.'
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - google-2015
                        name:
                          type: string
                          examples:
                            - 'Google 2015'
                        downloads:
                          type: integer
                          examples:
                            - 48230
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - technology
                              - search-engine
                        created_at:
                          type: string
                          examples:
                            - '2024-01-15T10:30:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-06-20T14:15:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/google-2015'
                    examples:
                      -
                        -
                          slug: google-2015
                          name: 'Google 2015'
                          downloads: 48230
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                          tags:
                            - technology
                            - search-engine
                          created_at: '2024-01-15T10:30:00+00:00'
                          updated_at: '2024-06-20T14:15:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                            web: 'https://worldvectorlogo.com/logo/google-2015'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=1'
                      last:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=13'
                      prev:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                      next:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=2'
                    description: 'Page URLs: `first`, `last`, `prev` and `next`. They keep your query parameters, so you can follow `next` as is; `prev`/`next` are null at the ends.'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        description: 'The page returned.'
                        examples:
                          - 1
                      from:
                        type: integer
                        description: 'Position of the first result on this page. Null when there are no results.'
                        examples:
                          - 1
                      last_page:
                        type: integer
                        description: 'Number of the last page.'
                        examples:
                          - 13
                      links:
                        type: array
                        description: 'A link per page, for building page buttons: `url`, `label`, `page` and `active`.'
                        items:
                          type: object
                          properties:
                            url:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            label:
                              type: string
                              examples:
                                - '&laquo; Previous'
                            page:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            active:
                              type: boolean
                              examples:
                                - false
                        examples:
                          -
                            -
                              url: null
                              label: '&laquo; Previous'
                              page: null
                              active: false
                            -
                              url: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=1'
                              label: '1'
                              page: 1
                              active: true
                            -
                              url: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=2'
                              label: '2'
                              page: 2
                              active: false
                            -
                              url: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=2'
                              label: 'Next &raquo;'
                              page: 2
                              active: false
                      path:
                        type: string
                        description: 'The endpoint URL without query parameters.'
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                      per_page:
                        type: integer
                        description: 'Results per page.'
                        examples:
                          - 20
                      to:
                        type: integer
                        description: 'Position of the last result on this page. Null when there are no results.'
                        examples:
                          - 20
                      total:
                        type: integer
                        description: 'Total number of results.'
                        examples:
                          - 245
                    description: 'Pagination details.'
                examples:
                  -
                    data:
                      -
                        slug: google-2015
                        name: 'Google 2015'
                        downloads: 48230
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/google-2015.svg'
                        tags:
                          - technology
                          - search-engine
                        created_at: '2024-01-15T10:30:00+00:00'
                        updated_at: '2024-06-20T14:15:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/google-2015'
                          web: 'https://worldvectorlogo.com/logo/google-2015'
                    links:
                      first: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=1'
                      last: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=13'
                      prev: null
                      next: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=2'
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 13
                      links:
                        -
                          url: null
                          label: '&laquo; Previous'
                          page: null
                          active: false
                        -
                          url: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=1'
                          label: '1'
                          page: 1
                          active: true
                        -
                          url: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=2'
                          label: '2'
                          page: 2
                          active: false
                        -
                          url: 'https://worldvectorlogo.com/api/v1/tags/technology/logos?per_page=20&page=2'
                          label: 'Next &raquo;'
                          page: 2
                          active: false
                      path: 'https://worldvectorlogo.com/api/v1/tags/technology/logos'
                      per_page: 20
                      to: 20
                      total: 245
        404:
          description: 'Tag not found'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - not_found
                      message:
                        type: string
                        examples:
                          - 'Tag not found.'
                examples:
                  -
                    error:
                      code: not_found
                      message: 'Tag not found.'
      tags:
        - Tag
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The tag slug.'
        required: true
        schema:
          type: string
          examples:
            - technology
  /api/v1/account/usage:
    get:
      summary: 'Get API usage statistics.'
      operationId: getAPIUsageStatistics
      description: "Returns credit balances for the current billing cycle plus daily usage\nbreakdown for the last 30 days."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      plan:
                        type: string
                        description: 'Your current plan tier (free or base).'
                        examples:
                          - free
                      credits:
                        type: object
                        properties:
                          plan_remaining:
                            type: integer
                            description: 'Plan credits left this billing cycle.'
                            examples:
                              - 980
                          addon_remaining:
                            type: integer
                            description: 'Permanent top-up credits left.'
                            examples:
                              - 0
                          monthly_allowance:
                            type: integer
                            description: 'Plan credits granted each billing cycle.'
                            examples:
                              - 1000
                          resets_at:
                            type: string
                            description: 'ISO 8601 timestamp when plan credits reset — your signup anniversary on Free, your Stripe renewal on Base.'
                            examples:
                              - '2026-10-21T00:00:00+00:00'
                        description: 'Credit wallet summary.'
                      tokens:
                        type: integer
                        description: 'Number of active API tokens.'
                        examples:
                          - 1
                      daily_breakdown:
                        type: object
                        properties:
                          '2026-09-15':
                            type: object
                            properties:
                              requests:
                                type: integer
                                examples:
                                  - 20
                              errors:
                                type: integer
                                examples:
                                  - 0
                              avg_response_time_ms:
                                type: integer
                                examples:
                                  - 28
                        description: 'Daily usage data keyed by date.'
                examples:
                  -
                    data:
                      plan: free
                      credits:
                        plan_remaining: 980
                        addon_remaining: 0
                        monthly_allowance: 1000
                        resets_at: '2026-10-21T00:00:00+00:00'
                      tokens: 1
                      daily_breakdown:
                        '2026-09-15':
                          requests: 20
                          errors: 0
                          avg_response_time_ms: 28
        401:
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    examples:
                      - Unauthenticated.
                examples:
                  -
                    message: Unauthenticated.
      tags:
        - Account
  /api/v1/sectors:
    get:
      summary: 'List all sectors.'
      operationId: listAllSectors
      description: "Every sector that has logos, with its logo count and the tags grouped\nunder it. Ordered by logo count, largest first. Not paginated: there are\nonly a few dozen sectors."
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 'List of sectors.'
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - automotive
                        name:
                          type: string
                          examples:
                            - Automotive
                        logos_count:
                          type: integer
                          examples:
                            - 132
                        tags:
                          type: array
                          items:
                            type: object
                            properties:
                              slug:
                                type: string
                                examples:
                                  - cars
                              name:
                                type: string
                                examples:
                                  - Cars
                          examples:
                            -
                              -
                                slug: cars
                                name: Cars
                              -
                                slug: motorcycles
                                name: Motorcycles
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/sectors/automotive'
                            logos:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos'
                    examples:
                      -
                        -
                          slug: automotive
                          name: Automotive
                          logos_count: 132
                          tags:
                            -
                              slug: cars
                              name: Cars
                            -
                              slug: motorcycles
                              name: Motorcycles
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/sectors/automotive'
                            logos: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos'
                examples:
                  -
                    data:
                      -
                        slug: automotive
                        name: Automotive
                        logos_count: 132
                        tags:
                          -
                            slug: cars
                            name: Cars
                          -
                            slug: motorcycles
                            name: Motorcycles
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/sectors/automotive'
                          logos: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos'
      tags:
        - Sector
      security: []
  '/api/v1/sectors/{slug}':
    get:
      summary: 'Get a single sector.'
      operationId: getASingleSector
      description: 'One sector with its logo count and tags.'
      parameters: []
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      slug:
                        type: string
                        description: 'Unique URL-safe identifier.'
                        examples:
                          - automotive
                      name:
                        type: string
                        description: 'Display name of the sector.'
                        examples:
                          - Automotive
                      logos_count:
                        type: integer
                        description: 'Published logos in this sector, each counted once.'
                        examples:
                          - 132
                      tags:
                        type: array
                        description: 'The tags grouped under this sector, each with `slug` and `name`.'
                        items:
                          type: object
                          properties:
                            slug:
                              type: string
                              examples:
                                - cars
                            name:
                              type: string
                              examples:
                                - Cars
                        examples:
                          -
                            -
                              slug: cars
                              name: Cars
                            -
                              slug: motorcycles
                              name: Motorcycles
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/api/v1/sectors/automotive'
                          logos:
                            type: string
                            examples:
                              - 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos'
                        description: 'Links to this sector: `self` and `logos`.'
                examples:
                  -
                    data:
                      slug: automotive
                      name: Automotive
                      logos_count: 132
                      tags:
                        -
                          slug: cars
                          name: Cars
                        -
                          slug: motorcycles
                          name: Motorcycles
                      links:
                        self: 'https://worldvectorlogo.com/api/v1/sectors/automotive'
                        logos: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos'
        404:
          description: 'Sector not found'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - not_found
                      message:
                        type: string
                        examples:
                          - 'Sector not found.'
                examples:
                  -
                    error:
                      code: not_found
                      message: 'Sector not found.'
      tags:
        - Sector
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The sector slug.'
        required: true
        schema:
          type: string
          examples:
            - automotive
  '/api/v1/sectors/{slug}/logos':
    get:
      summary: 'Get logos in a sector.'
      operationId: getLogosInASector
      description: "Published logos tagged with the sector or any of its tags, most\ndownloaded first."
      parameters:
        -
          in: query
          name: page
          description: 'Page number.'
          required: false
          schema:
            type: integer
            description: 'Page number.'
            examples:
              - 1
        -
          in: query
          name: per_page
          description: 'Results per page (1-50).'
          required: false
          schema:
            type: integer
            description: 'Results per page (1-50).'
            examples:
              - 20
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: 'List of logo objects.'
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                          examples:
                            - tesla-motors
                        name:
                          type: string
                          examples:
                            - 'Tesla Motors'
                        downloads:
                          type: integer
                          examples:
                            - 31200
                        svg_url:
                          type: string
                          examples:
                            - 'https://cdn.worldvectorlogo.com/logos/tesla-motors.svg'
                        tags:
                          type: array
                          items:
                            type: string
                          examples:
                            -
                              - cars
                              - electric-vehicles
                        created_at:
                          type: string
                          examples:
                            - '2024-01-15T10:30:00+00:00'
                        updated_at:
                          type: string
                          examples:
                            - '2024-06-20T14:15:00+00:00'
                        links:
                          type: object
                          properties:
                            self:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/api/v1/logos/tesla-motors'
                            web:
                              type: string
                              examples:
                                - 'https://worldvectorlogo.com/logo/tesla-motors'
                    examples:
                      -
                        -
                          slug: tesla-motors
                          name: 'Tesla Motors'
                          downloads: 31200
                          svg_url: 'https://cdn.worldvectorlogo.com/logos/tesla-motors.svg'
                          tags:
                            - cars
                            - electric-vehicles
                          created_at: '2024-01-15T10:30:00+00:00'
                          updated_at: '2024-06-20T14:15:00+00:00'
                          links:
                            self: 'https://worldvectorlogo.com/api/v1/logos/tesla-motors'
                            web: 'https://worldvectorlogo.com/logo/tesla-motors'
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=1'
                      last:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=7'
                      prev:
                        type:
                          - string
                          - 'null'
                        examples:
                          - null
                      next:
                        type: string
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=2'
                    description: 'Page URLs: `first`, `last`, `prev` and `next`. They keep your query parameters, so you can follow `next` as is; `prev`/`next` are null at the ends.'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        description: 'The page returned.'
                        examples:
                          - 1
                      from:
                        type: integer
                        description: 'Position of the first result on this page. Null when there are no results.'
                        examples:
                          - 1
                      last_page:
                        type: integer
                        description: 'Number of the last page.'
                        examples:
                          - 7
                      links:
                        type: array
                        description: 'A link per page, for building page buttons: `url`, `label`, `page` and `active`.'
                        items:
                          type: object
                          properties:
                            url:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            label:
                              type: string
                              examples:
                                - '&laquo; Previous'
                            page:
                              type:
                                - string
                                - 'null'
                              examples:
                                - null
                            active:
                              type: boolean
                              examples:
                                - false
                        examples:
                          -
                            -
                              url: null
                              label: '&laquo; Previous'
                              page: null
                              active: false
                            -
                              url: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=1'
                              label: '1'
                              page: 1
                              active: true
                            -
                              url: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=2'
                              label: '2'
                              page: 2
                              active: false
                            -
                              url: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=2'
                              label: 'Next &raquo;'
                              page: 2
                              active: false
                      path:
                        type: string
                        description: 'The endpoint URL without query parameters.'
                        examples:
                          - 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos'
                      per_page:
                        type: integer
                        description: 'Results per page.'
                        examples:
                          - 20
                      to:
                        type: integer
                        description: 'Position of the last result on this page. Null when there are no results.'
                        examples:
                          - 20
                      total:
                        type: integer
                        description: 'Total number of results.'
                        examples:
                          - 132
                    description: 'Pagination details.'
                examples:
                  -
                    data:
                      -
                        slug: tesla-motors
                        name: 'Tesla Motors'
                        downloads: 31200
                        svg_url: 'https://cdn.worldvectorlogo.com/logos/tesla-motors.svg'
                        tags:
                          - cars
                          - electric-vehicles
                        created_at: '2024-01-15T10:30:00+00:00'
                        updated_at: '2024-06-20T14:15:00+00:00'
                        links:
                          self: 'https://worldvectorlogo.com/api/v1/logos/tesla-motors'
                          web: 'https://worldvectorlogo.com/logo/tesla-motors'
                    links:
                      first: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=1'
                      last: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=7'
                      prev: null
                      next: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=2'
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 7
                      links:
                        -
                          url: null
                          label: '&laquo; Previous'
                          page: null
                          active: false
                        -
                          url: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=1'
                          label: '1'
                          page: 1
                          active: true
                        -
                          url: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=2'
                          label: '2'
                          page: 2
                          active: false
                        -
                          url: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos?per_page=20&page=2'
                          label: 'Next &raquo;'
                          page: 2
                          active: false
                      path: 'https://worldvectorlogo.com/api/v1/sectors/automotive/logos'
                      per_page: 20
                      to: 20
                      total: 132
        404:
          description: 'Sector not found'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        examples:
                          - not_found
                      message:
                        type: string
                        examples:
                          - 'Sector not found.'
                examples:
                  -
                    error:
                      code: not_found
                      message: 'Sector not found.'
      tags:
        - Sector
      security: []
    parameters:
      -
        in: path
        name: slug
        description: 'The sector slug.'
        required: true
        schema:
          type: string
          examples:
            - automotive