API reference

OpenAPI docs for semantic content discovery.

Browse endpoints, parameters, response shapes, and examples for building with curaft feeds.

Endpoints

Start with item search for content results or feed suggestions for query ideas. The API index describes the current quota and available routes.

GET/api/v1

Returns API metadata, documentation links, available endpoints, and the current public rate limit.

GET/api/v1/items

Returns normalized content items for one or more semantic queries, with pagination, ordering, and freshness controls.

GET/api/v1/feed-suggestions

Returns preset and AI-assisted semantic feed suggestions for a natural-language query.

Parameter	Use
`query`	One or more semantic searches. Repeat the parameter to combine several searches.
`page`	The result page to return.
`limit`	The number of items to return. per_page is also accepted.
`sort`	Order results by relevance, newest, or oldest.
`time_range`	Limit freshness with a window such as last_7_days or last_30_days.

curl "https://curaft.com/api/v1/items?query=technical%20SEO&limit=10&time_range=last_30_days"

No API key is required for the public quota. Responses include rate-limit headers; a 429 response means the current IP-based quota has been reached.

curaft API v1