DevelopersAPI

Plurel public API

Last updated

Plurel publishes a small, read-only JSON API for developers and AI agents. It returns what plurelinc.com already shows: facts about the company, its products and team, and the news. It needs no key.

The machine-readable description is the OpenAPI 3.1 specification. For AI assistants there’s also llms.txt and llms-full.txt.

01Authentication

None. Every endpoint is public and read-only. Responses are JSON with open CORS, so browsers can call them directly. The base URL is https://plurelinc.com.

02Endpoints

  • GET /api/v1/company (getCompany): Returns Plurel's description, location, contact details, products, how it works, team and useful links. Use it to answer questions about the company.
    curl https://plurelinc.com/api/v1/company
  • GET /api/v1/news (listNews): Returns every published post on plurelinc.com/news, newest first, with title, summary, date, author and links. Fetch one post's full text with getNewsPost.
    curl https://plurelinc.com/api/v1/news
  • GET /api/v1/news/{slug} (getNewsPost): Returns one published post with its body in Markdown. The slug comes from listNews or from the post's URL (plurelinc.com/news/{slug}).
    curl https://plurelinc.com/api/v1/news/<slug>

03Errors

Errors are JSON objects with a code, a message and a hint for fixing the request:

{ "error": { "code": "not_found", "message": "No published post has the slug \"x\".", "hint": "List published posts with GET /api/v1/news.", "status": 404, "docs": "https://plurelinc.com/developers" } }

Codes: not_found (404), invalid_request (400), method_not_allowed (405), rate_limited (429), internal_error (500).

04Rate limits

60 requests per 60 seconds per network. Every response carries the IETF RateLimit header fields, so you can slow down before you hit the limit:

RateLimit-Policy: "default";q=60;w=60
RateLimit: "default";r=59;t=42

r is requests left and t the seconds until the window resets. A 429 also carries Retry-After.

05Pages as Markdown

Any content page is available as Markdown: request it with Accept: text/markdown (the response carries Vary: Accept) or add .md to its path, for example /index.md.

curl -H 'Accept: text/markdown' https://plurelinc.com/

06What it doesn’t do

Joining the waitlist needs a person in a browser, because the form is protected against bots: send people to the newsletter. For pilots, partnerships, press or investors, see contact.