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

# Search publications

> Search for publications by name, slug, or description. Returns results ranked by relevance and subscriber count.



## OpenAPI

````yaml /paragraph-api/openapi.json get /v1/discover/blogs/search
openapi: 3.1.0
info:
  title: Paragraph API
  version: 1.0.0
  description: >-
    Public API for interacting with Paragraph publications, posts, users, and
    coined writing.


    ## Rate Limiting

    API requests are rate-limited to ensure fair usage. Contact
    support@paragraph.com for higher limits.


    ## Pagination

    List endpoints support cursor-based pagination using `cursor` and `limit`
    parameters.
  contact:
    name: Paragraph Support
    email: support@paragraph.com
    url: https://paragraph.com/support
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://public.api.paragraph.com/api
    description: Production server
security:
  - {}
tags:
  - name: publications
    description: Operations related to publications
  - name: posts
    description: Operations related to posts and content
  - name: users
    description: Operations related to users and authors
  - name: coins
    description: Operations related to tokenized content
  - name: subscribers
    description: Operations related to subscriber management (requires API key)
paths:
  /v1/discover/blogs/search:
    get:
      tags:
        - discover
      summary: Search publications
      description: >-
        Search for publications by name, slug, or description. Returns results
        ranked by relevance and subscriber count.
      operationId: searchBlogs
      parameters:
        - name: q
          in: query
          description: Search query string
          schema:
            type: string
      responses:
        '200':
          description: Publication search results
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    blog:
                      type: object
                      properties:
                        blogId:
                          type: string
                          description: Unique identifier for the publication
                        userId:
                          type: string
                          description: ID of the publication owner
                        name:
                          type:
                            - string
                            - 'null'
                          description: Display name of the publication
                        url:
                          type:
                            - string
                            - 'null'
                          description: URL of the publication
                        slug:
                          type:
                            - string
                            - 'null'
                          description: URL-friendly slug of the publication
                        logoUrl:
                          type:
                            - string
                            - 'null'
                          description: URL to the publication's logo
                        coinId:
                          type:
                            - string
                            - 'null'
                          description: Associated coin ID, if any
                        customDomain:
                          type:
                            - string
                            - 'null'
                          description: Custom domain for the publication
                        summary:
                          type:
                            - string
                            - 'null'
                          description: Brief description of the publication
                      required:
                        - blogId
                        - userId
                        - name
                        - url
                        - slug
                        - logoUrl
                        - coinId
                      description: The matched publication
                    user:
                      type: object
                      properties:
                        userId:
                          type: string
                          description: Unique identifier for the user
                        name:
                          type:
                            - string
                            - 'null'
                          description: Display name of the author
                        bio:
                          type:
                            - string
                            - 'null'
                          description: Brief biography of the author
                        avatarUrl:
                          type:
                            - string
                            - 'null'
                          description: URL to the author's avatar
                        walletAddress:
                          type:
                            - string
                            - 'null'
                          description: Wallet address of the author
                      required:
                        - userId
                        - name
                      description: The publication owner
                    activeSubscriberCount:
                      type: number
                      description: Number of active subscribers to this publication
                  required:
                    - blog
                    - user
                    - activeSubscriberCount
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                    description: Always false for error responses
                  msg:
                    type: string
                    description: Human-readable error message
                required:
                  - success
                  - msg
      x-codeSamples:
        - lang: typescript
          label: Search publications
          source: |-
            import { ParagraphAPI } from "@paragraph-com/sdk"

            const api = new ParagraphAPI()
            const results = await api.discover.searchBlogs({ q: "crypto" })
        - lang: bash
          label: Search publications using curl
          source: >-
            curl
            "https://public.api.paragraph.com/api/v1/discover/blogs/search?q=crypto"

````