Integrations / Headless API
A headless API
for your SEO articles
Your Next.js, Nuxt, Astro or Remix site reads published articles from Searchloom: HTML, Markdown, image and schema, ready to render.
Headless API
What your
site receives
Works with any site that can make an HTTP request, at build time or on each visit. Nothing to install.
- List of articles
- Slug, title, description, image, link and dates, newest first, up to 100 per request.
- HTML and Markdown
- The full article in both formats, so you can render it however you like.
- Image
- The featured image's address and alt text.
- Schema
- Article structured data (JSON-LD) to put in your page's head.
- Keywords and dates
- The article's keywords, publish date and last update.
Example request
Two addresses, one private key
Your key and project address are shown in Searchloom after you choose Headless API, with ready-to-use Next.js code.
# Newest articles first (use ?limit= and ?offset= to page)
curl https://app.usesearchloom.com/api/feed/<project-id>/articles \
-H "Authorization: Bearer <your-feed-key>"
# One article, with HTML, Markdown and schema
curl https://app.usesearchloom.com/api/feed/<project-id>/articles/how-to-choose-a-coffee-subscription \
-H "Authorization: Bearer <your-feed-key>"
Setup ( 3 steps )
Connect your site
in a few minutes
- 01
Choose Headless API
In Searchloom, open Publishing and choose Headless API. You get a private key and the two addresses.
- 02
Fetch your articles
Read the list and single-article addresses from your site, at build time or on each request. We show example code for Next.js.
- 03
Render and go
Use the HTML or Markdown, put the schema in your page's head, and your articles are live.
Headless API FAQ ( 3 )
Questions,
answered
Is the key safe to use in the browser?
Keep it on your server. It only gives read access to articles you've already published, but it's still meant to be private.
When do articles appear in the API?
As soon as they're published, on their scheduled day or when you click Publish.
Is there caching?
Responses can be cached for up to a minute, so a just-published article shows up quickly.
More integrations