Search

Full-text search within the content of a publication.

---

Search Issue Text

GET /api/v1/issue-text-content

Searches the indexed text content of an issue using full-text search. Returns matching snippets with highlighted query words.

Authentication: Requires reader-token header.

Request:

curl "https://store.publica.la/api/v1/issue-text-content?issue_id=12345&search=quantum%20physics" \
  -H "reader-token: {session_token}" \
  -H "Accept: application/json"

Parameter	Type	Required	Description
issue_id	integer	Yes	Issue to search within
search	string (4-128 chars)	Yes	Search term

Response: 200 OK

[
  {
    "location": "page_5_section_2",
    "snippet": "Text snippet with <b>quantum</b> <b>physics</b> highlighted",
    "query_words": ["quantum", "physics"]
  }
]

• Returns up to 50 results, ordered by relevance
• Snippets include <b> tags around matched words
• Returns 403 if the tenant does not have access to the issue
• Returns 404 if the issue has no indexed text content

---

Get All Text Content

GET /api/v1/issue-text-content/{id}

Returns all indexed text content records for an issue. Used for bulk text retrieval.

Authentication: None

Request:

curl "https://store.publica.la/api/v1/issue-text-content/12345?issue_id=12345" \
  -H "Accept: application/json"

Parameter	Type	Required	Description
issue_id	integer	Yes	Issue to fetch text for

Response: 200 OK — array of IssueTextContent records.

---

See Also

• Sessions - How to obtain the reader-token
• Notes - Highlights and annotations
• Integrations - Translate, dictionary, AI features