List posts | Algorhythm | Documentation

Returns your team’s posts across all farm profiles, newest first. In-flight posts are included with status processing; platform_post_id and url populate once each post is live.

Rate limit: 100 requests per minute per team.

Authentication

X-API-Keystring

API Key authentication via header

Query parameters

cursorstring or nullOptional

Opaque pagination cursor from a previous response’s next_cursor.

limitintegerOptional<=100Defaults to 20

Maximum number of posts to return (max 100).

Response

Successful Response

postslist of objects

has_moreboolean

Whether more results exist beyond this page.

next_cursorstring or null

Opaque cursor for the next page. Pass back as the cursor query parameter. null when no more pages.

Errors

422

Unprocessable Entity Error

429

Too Many Requests Error

1	{
2	"posts": [
3	{
4	"post_id": "273a704c-0114-4e9e-a574-e8ae3a4d427e",
5	"profile_id": "f8a1c2d4-3b7e-4f9a-9c2d-1e5b7a8f9c3d",
6	"status": "posted",
7	"platform_post_id": "7255433468434549509",
8	"url": "https://www.tiktok.com/@greenvalleyfarm/video/7255433468434549509"
9	},
10	{
11	"post_id": "4154a282-2759-4d3a-beb9-4f7c3fcfb1a6",
12	"profile_id": "f8a1c2d4-3b7e-4f9a-9c2d-1e5b7a8f9c3d",
13	"status": "processing",
14	"platform_post_id": null,
15	"url": null
16	}
17	],
18	"has_more": false,
19	"next_cursor": "eyJvZmZzZXQiOiAyMH0="
20	}

$	curl https://api.algorhythm.app/v1/posts \
>	-H "X-API-Key: <apiKey>"