---
title: "Search posts by keyword (1-25, limit 300/day). Returns post_id (e.g. 'urn:li:activity:701...'), engagement, and author."
method: GET
path: "/api/v1/search/posts"
tags: ["search"]
---

# Search posts by keyword (1-25, limit 300/day). Returns post_id (e.g. 'urn:li:activity:701...'), engagement, and author.

`GET /api/v1/search/posts`

## Request

- Base URL: `https://crispy.sh`
- URL: `https://crispy.sh/api/v1/search/posts`
- Auth: HTTP bearer

## Query parameters

- `keyword` string, required: Search keyword to find in posts
- `keywords` string: Alias for keyword.
- `limit` number: Max results to return (1-25, default 10)
- `cursor` string: Pagination cursor
- `posted_within_days` 1 | 7 | 30: Return only posts published within 1, 7, or 30 days. Undated posts are excluded.

## Response `200`

Success

## Other responses

- `401`: Missing or expired API key
- `403`: Insufficient key scope or permission denied
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crispy/apis/crispy-rest-api.md) · [All operations](https://skmtc.dev/crispy/apis/crispy-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crispy/apis/crispy-rest-api/revisions/6bed0974d9ce?raw)