resources

Read what was indexed

The text of the published version, in Markdown, as the assistants search it, with what reading could not use. Up to 200,000 characters; for a long resource read a window with offset and limit and continue from next_offset.

GET/v1/resources/{resource_id}/content

Request

curl --request GET \
  --url 'https://api.lookio.app/v1/resources/<resource_id>/content' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.lookio.app/v1/resources/<resource_id>/content"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://api.lookio.app/v1/resources/<resource_id>/content", {
  method: "GET",
  headers: {
    "Authorization": "<api-key>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.lookio.app/v1/resources/<resource_id>/content");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.lookio.app/v1/resources/<resource_id>/content", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.lookio.app/v1/resources/<resource_id>/content"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.lookio.app/v1/resources/<resource_id>/content")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

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

puts response.body

application/json

{
  "data": {
    "title": "<string>",
    "type": "text",
    "file_name": null,
    "page_count": 123,
    "passages": 123,
    "warnings": [
      "<string>"
    ],
    "text": "<string>",
    "truncated": true,
    "has_more": true,
    "offset": 123,
    "total_chars": 123,
    "next_offset": 123
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}

Requires resources:read.

Use this to check an import before you rely on it. The text holds up to 200,000 characters. For a long resource, read a window with offset and limit (in characters), and continue from next_offset until it is null.

warnings lists what reading could not use, such as pages without readable text.

Authorizations

Authorizationbearerin headerrequired

Path parameters

resource_idstringrequiredpattern: ^res_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Query parameters

offsetintegerrange: ≥ 0

Where to start, in characters. Default 0. Pass next_offset from the previous response to read on.

limitintegerrange: 1–200000

How many characters to return, at most 200,000. Omit it to read everything from offset.

Response

application/json

Read what was indexed

dataobjectrequired

Show child attributes

data.titlestringrequired

data.typeenum<string>requiredone of: text, file, url, site

data.file_namestringnullrequired

data.page_countinteger | nullrequired

data.passagesinteger | nullrequired

How many passages the published version was cut into.

data.warningsstring[]required

What reading could not use, such as pages without readable text.

data.textstringrequired

The text as indexed, in Markdown, from offset for at most limit characters.

data.truncatedbooleanrequired

True when the resource itself is longer than the 200,000 characters Lookio keeps readable. It says nothing about this window: for that, read has_more or next_offset.

data.has_morebooleanrequired

True when more text follows this window: continue at next_offset.

data.offsetintegerrequired

Where text starts, in characters.

data.total_charsintegerrequired

The length of the readable text (at most 200,000).

data.next_offsetinteger | nullrequired

Where to continue, or null when text reaches the end.

request_idstringrequired

{ "data": { "title": "<string>", "type": "text", "file_name": null, "page_count": 123, "passages": 123, "warnings": [ "<string>" ], "text": "<string>", "truncated": true, "has_more": true, "offset": 123, "total_chars": 123, "next_offset": 123 }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>" }, "request_id": "<string>" }

Read what was indexed

Authorizations

Path parameters

Query parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown