API quickstart

curl -X POST https://api.lyrenth.com/v1/aidocument \
  -H "Authorization: Bearer $LYRENTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://en.wikipedia.org/wiki/Web_indexing"}'

# pip install lyrenth
from lyrenth import Lyrenth

client = Lyrenth()            # reads LYRENTH_API_KEY from the environment
doc = client.read("https://en.wikipedia.org/wiki/Web_indexing")

print(doc.title)
print(doc.word_count, "words")
print(doc.markdown[:400])
# doc.raw is the full AIDocument envelope shown in step 04.

// npm install lyrenth
import { Lyrenth } from "lyrenth";

const lyrenth = new Lyrenth();   // reads LYRENTH_API_KEY from the environment
const doc = await lyrenth.read("https://en.wikipedia.org/wiki/Web_indexing");

console.log(doc.title);
console.log(doc.wordCount, "words");
// doc.raw is the full AIDocument envelope shown in step 04.

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

type aiDocument struct {
	Identity struct {
		Title string `json:"title"`
	} `json:"identity"`
	Signals struct {
		WordCount int `json:"word_count"`
	} `json:"signals"`
	Content struct {
		Markdown string `json:"markdown"`
	} `json:"content"`
}

func main() {
	body, err := json.Marshal(map[string]string{"url": "https://en.wikipedia.org/wiki/Web_indexing"})
	if err != nil {
		panic(err)
	}

	req, err := http.NewRequest(http.MethodPost,
		"https://api.lyrenth.com/v1/aidocument", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("LYRENTH_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	var doc aiDocument
	if err := json.NewDecoder(res.Body).Decode(&doc); err != nil {
		panic(err)
	}
	fmt.Println(doc.Identity.Title)
	fmt.Println(doc.Signals.WordCount, "words")
}

// Java 11 or later, no dependencies.
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ReadUrl {
    public static void main(String[] args) throws Exception {
        String body = "{\"url\":\"https://en.wikipedia.org/wiki/Web_indexing\"}";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.lyrenth.com/v1/aidocument"))
                .header("Authorization", "Bearer " + System.getenv("LYRENTH_API_KEY"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
                .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());   // the envelope from step 04
    }
}

// .NET 6 or later, no packages.
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;

var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("LYRENTH_API_KEY"));

var body = new StringContent(
    "{\"url\":\"https://en.wikipedia.org/wiki/Web_indexing\"}",
    Encoding.UTF8, "application/json");

var response = await http.PostAsync("https://api.lyrenth.com/v1/aidocument", body);
response.EnsureSuccessStatusCode();

using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
var root = doc.RootElement;

Console.WriteLine(root.GetProperty("identity").GetProperty("title").GetString());
Console.WriteLine(root.GetProperty("signals").GetProperty("word_count").GetInt32() + " words");

<?php
// ext-curl, no packages.
$ch = curl_init("https://api.lyrenth.com/v1/aidocument");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer " . getenv("LYRENTH_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS     => json_encode(["url" => "https://en.wikipedia.org/wiki/Web_indexing"]),
]);

$doc = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $doc["identity"]["title"], "\n";
echo $doc["signals"]["word_count"], " words\n";

# Ruby standard library, no gems.
require "json"
require "net/http"
require "uri"

uri = URI("https://api.lyrenth.com/v1/aidocument")

request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV['LYRENTH_API_KEY']}"
request["Content-Type"] = "application/json"
request.body = JSON.dump({ url: "https://en.wikipedia.org/wiki/Web_indexing" })

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

doc = JSON.parse(response.body)
puts doc["identity"]["title"]
puts "#{doc['signals']['word_count']} words"

// Cargo.toml
//   reqwest    = { version = "0.12", features = ["json"] }
//   tokio      = { version = "1", features = ["full"] }
//   serde_json = "1"
use serde_json::{json, Value};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let key = std::env::var("LYRENTH_API_KEY")?;

    let doc: Value = reqwest::Client::new()
        .post("https://api.lyrenth.com/v1/aidocument")
        .bearer_auth(key)
        .json(&json!({ "url": "https://en.wikipedia.org/wiki/Web_indexing" }))
        .send()
        .await?
        .json()
        .await?;

    println!("{}", doc["identity"]["title"]);
    println!("{} words", doc["signals"]["word_count"]);
    Ok(())
}