# Social Rights Advocacy Centre (socialrights.ca)

> The Social Rights Advocacy Centre (SRAC) maintains a full-text searchable research collection of HTML pages and PDF documents on social and economic rights, Charter litigation, housing, poverty, equality, and international human rights law in Canada and internationally.

The collection is best accessed through the public, read-only search API rather than by crawling: every page and PDF on the site is indexed (PDFs page by page, with OCR for scanned documents), and the index is rebuilt nightly.

## Search API

- Endpoint: https://jacksaiapps.com/srac/public-api/site-search?q=QUERY
- Method: GET, no authentication, JSON responses, CORS enabled.
- Parameters: `q` (query, required), `limit` (default 20, max 200), `source_page` / `source_pages` (restrict to one or more HTML pages and the PDFs they link to).
- Each result has: `kind` (page|pdf), `title`, `url` (cite this; PDFs include `#page=N`), `rel_path`, `page`, `snippet` (with <mark> highlights), `snippet_text` (plain text), `score`.
- Every response carries `build` metadata: `built_at`, `html_count`, `pdf_count`, `row_count`, `citation_count`, `orphan_count`, `warning_count`.
- Collection manifest (metadata only, paginated): https://jacksaiapps.com/srac/public-api/documents
- Rate limits: 300 requests/minute and 3,000/hour per IP; 1,200/minute overall. HTTP 429 with Retry-After when exceeded.

## Documentation

- Human-readable docs: https://www.socialrights.ca/resources/search-api.html
- OpenAPI 3.1: https://www.socialrights.ca/openapi.json (live copy: https://jacksaiapps.com/srac/public-api/openapi.json)
- Sitemap: https://www.socialrights.ca/sitemap.xml

## Terms

This API is provided to facilitate research, retrieval, citation, and analysis of materials in the Social Rights Advocacy Centre collection. Please use reasonable request rates and cite original documents using the URLs provided in search results.

## Optional

- Main site: https://www.socialrights.ca/
- Resources section: https://www.socialrights.ca/resources/index.html
- Contact: https://www.socialrights.ca/contactus.htm