---
title: "Search posts"
method: GET
path: "/v1/discover/search"
tags: ["discover"]
---

# Search posts

`GET /v1/discover/search`

Search for posts across all publications. Returns results ranked by relevance, popularity, and recency.

## Query parameters

- `q` string
- `blogId` string

## Response `200`

Post search results

- object[]
  - `post` object, required — The matched post
    - `postId` string, required — Unique identifier for the post
    - `blogId` string, required — ID of the publication this post belongs to
    - `createdAt` string, required — Timestamp when the post was created
    - `publishedAt` string, nullable, required — Timestamp when the post was published
    - `title` string, nullable, required — Title of the post
    - `subtitle` string, nullable, required — Subtitle of the post
    - `postPreview` string, nullable, required — Preview text of the post
    - `coverImageUrl` string, nullable, required — URL to the post's cover image
    - `slug` string, nullable, required — URL-friendly identifier for the post
    - `coinId` string, nullable, required — Associated coin ID, if any
  - `blog` object, required — The publication this post belongs to
    - `blogId` string, required — Unique identifier for the publication
    - `userId` string, required — ID of the publication owner
    - `name` string, nullable, required — Display name of the publication
    - `url` string, nullable, required — URL of the publication
    - `slug` string, nullable, required — URL-friendly slug of the publication
    - `logoUrl` string, nullable, required — URL to the publication's logo
    - `coinId` string, nullable, required — Associated coin ID, if any
    - `customDomain` string, nullable — Custom domain for the publication
    - `summary` string, nullable — Brief description of the publication
  - `user` object, required — The author of the post
    - `userId` string, required — Unique identifier for the user
    - `name` string, nullable, required — Display name of the author
    - `bio` string, nullable — Brief biography of the author
    - `avatarUrl` string, nullable — URL to the author's avatar
    - `walletAddress` string, nullable — Wallet address of the author

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/paragraph-xyz/apis/paragraph-api.md) · [All operations](https://skmtc.net/paragraph-xyz/apis/paragraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paragraph-xyz/paragraph-api/versions/7bbf1b62c1a0/schema)