> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetopublish.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List blogs

> This API allows to list all the blogs in a workspace.

<Warning>
  **Deprecated:** This is a **v1** endpoint. It will continue to work, but we
  recommend migrating to the [v2 equivalent](/api-reference) for improved REST
  compliance (correct HTTP status codes, consistent response envelopes, and
  hyphenated URLs).
</Warning>

<Info>Replace `{your-subdomain}` with your workspace's subdomain. <br /> Learn how to find your subdomain in [Workspace subdomain](/getting-started/workspace-subdomain).</Info>


## OpenAPI

````yaml bundled-v1/blogs.yaml GET /blog_posts
openapi: 3.0.3
info:
  title: NeetoPublish Blogs APIs
  version: 1.0.0
servers:
  - description: NeetoPublish APIs
    url: https://{your-subdomain}.neetopublish.com/api/external/v1
    variables:
      your-subdomain:
        default: spinkart
        description: >-
          Replace **spinkart** with your [workspace's
          subdomain](/getting-started/workspace-subdomain).
security: []
paths:
  /blog_posts:
    get:
      tags:
        - Blogs
      summary: List all blogs
      description: This API allows to list all the blogs in a workspace.
      parameters:
        - $ref: '#/components/parameters/api_key_header'
      responses:
        '200':
          description: OK - Request succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blog_posts_response'
components:
  parameters:
    api_key_header:
      in: header
      name: X-Api-Key
      description: >-
        Use the X-Api-Key header to provide your workspace API key. Refer to
        [Authentication](/getting-started/authentication) for more information.
      required: true
      schema:
        type: string
        default: your-api-key
  schemas:
    blog_posts_response:
      type: object
      properties:
        blog_posts:
          type: array
          items:
            $ref: '#/components/schemas/blog_post_list'
        blog_name:
          type: string
          example: Acme Engineering Blog
    blog_post_list:
      type: object
      properties:
        slug:
          type: string
          example: getting-started-with-api-integration
        title:
          type: string
          example: Getting Started with API Integration
        publication_date:
          type: string
          format: date-time
          example: '2026-03-15T10:30:00.000Z'
        authors:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
                example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
              name:
                type: string
                example: Oliver Smith
              profile_image_url:
                type: string
                example: https://example.com/avatars/oliver-smith.jpg
              email:
                type: string
                example: oliver@example.com
        page_title:
          type: string
          nullable: true
          example: Getting Started with API Integration
        meta_description:
          type: string
          nullable: true
          example: A comprehensive guide on how to integrate APIs into your workflow.
        keywords:
          type: array
          items:
            type: string
          nullable: true
          example:
            - api
            - integration
            - guide
            - tutorial
        cover_image_url:
          type: string
          nullable: true
          example: https://example.com/images/api-integration-cover.jpg
        thumbnail_image_url:
          type: string
          nullable: true
          example: ''

````