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. `` 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: - '« Previous' page: type: - string - 'null' examples: - null active: type: boolean examples: - false examples: - - url: null label: '« 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 »' 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: '« 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 »' 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: - '« Previous' page: type: - string - 'null' examples: - null active: type: boolean examples: - false examples: - - url: null label: '« 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 »' 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: '« 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 »' 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: - '...' 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: '...' 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`` 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: - '' 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: - '« Previous' page: type: - string - 'null' examples: - null active: type: boolean examples: - false examples: - - url: null label: '« 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 »' 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: '« 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 »' 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: - '« Previous' page: type: - string - 'null' examples: - null active: type: boolean examples: - false examples: - - url: null label: '« 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 »' 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: '« 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 »' 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