Skip to main content
GET
/
v1
/
posts
/
search
Search posts by content
curl --request GET \
  --url https://api.yalg.ai/v1/posts/search \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "018f9f40-7d7b-7712-9b0f-2e5d9fd5df3f",
    "anecdoteId": "018f9f41-22a1-74bb-9450-7dd0d21ab8ab",
    "content": "I used to think consistency came from discipline. It actually came from removing friction.",
    "platform": "linkedin",
    "status": "draft",
    "likes": 12,
    "comments": 3,
    "shares": 1,
    "createdAt": "2026-06-20T17:24:39.000Z",
    "updatedAt": "2026-06-20T17:24:39.000Z"
  }
]

Authorizations

​
x-api-key
string
header
default:yalg_live_your_api_key
required

YALG Developer API key. Send it in the x-api-key header from a server-side environment only.

Query Parameters

​
q
string
required

Search term

Example:

"technology conference"

​
page
number

Page number (default: 1)

Example:

1

​
limit
number

Number of posts per page (default: 10)

Example:

10

Response

Search results retrieved successfully

Social post managed by YALG.

​
id
string<uuid>

Post identifier.

Example:

"018f9f40-7d7b-7712-9b0f-2e5d9fd5df3f"

​
anecdoteId
string<uuid>

Source anecdote identifier.

Example:

"018f9f40-7d7b-7712-9b0f-2e5d9fd5df3f"

​
content
string
Example:

"A publishable LinkedIn post generated from an anecdote."

​
platform
string
Example:

"linkedin"

​
status
string
Example:

"draft"

​
scheduledAt
string<date-time>
Example:

"2026-06-20T17:24:39.000Z"

​
publishedAt
string<date-time>
Example:

"2026-06-20T17:24:39.000Z"

​
likes
integer
Example:

12

​
comments
integer
Example:

3

​
shares
integer
Example:

1

​
createdAt
string<date-time>
Example:

"2026-06-20T17:24:39.000Z"

​
updatedAt
string<date-time>
Example:

"2026-06-20T17:24:39.000Z"