API Documentation

Programmatic access to ICA conference data.

These endpoints serve the same 2003–2018 paper, author, and session data used by the web interface. All responses are JSON. List endpoints are paginated.

Base URL: https://your-deployment-url

GET/api/search

Semantic search over ICA paper title and abstract embeddings.

Parameters

q: Required. Keyword, sentence, abstract, or paragraph.
k: Optional. Number of results, 1–25. Default: 10.

Example

/api/search?q=social%20media%20misinformation%20and%20political%20polarization&k=5

GET/api/papers

Paginated paper records with optional filters.

Parameters

page: Optional. Page number. Default: 1.
limit: Optional. Items per page, max 100. Default: 25.
title_contains: Optional. Case-insensitive title match.
abstract_contains: Optional. Case-insensitive abstract match.
has_author: Optional. Case-insensitive author name match.
year: Optional. Exact conference year.
paper_type: Optional. Exact paper type.
session_contains: Optional. Case-insensitive session title match.
session_id: Optional. Exact session ID.

Example

/api/papers?title_contains=communication&year=2003&limit=10

GET/api/papers/[paper_id]

Detailed record for one paper.

Parameters

paper_id: Required in path. Example: 2003-8726c2764aa326c8.

Example

/api/papers/2003-8726c2764aa326c8

GET/api/authors

Paginated author records with optional filters.

Parameters

page: Optional. Page number. Default: 1.
limit: Optional. Items per page, max 100. Default: 25.
author_name: Optional. Case-insensitive author name match.
affiliation_contains: Optional. Case-insensitive affiliation match.
year_attended: Optional. Exact conference year.
min_attend_count: Optional. Minimum attended-year count.
min_paper_count: Optional. Minimum paper count.

Example

/api/authors?author_name=Claes&limit=5

GET/api/sessions

Paginated session records with optional filters.

Parameters

page: Optional. Page number. Default: 1.
limit: Optional. Items per page, max 100. Default: 25.
session: Optional. Case-insensitive session title match.
chair_name: Optional. Case-insensitive chair name match.
division: Optional. Case-insensitive division match.
year: Optional. Exact conference year.
paper_count: Optional. Exact paper count.

Example

/api/sessions?division=Game%20Studies&limit=5

Response shape

List endpoints return pagination metadata plus an items array. Semantic search returns query, count, and results.

{
  "page": 1,
  "limit": 10,
  "total": 124,
  "totalPages": 13,
  "items": [
    {
      "paper_id": "2003-...",
      "title": "...",
      "abstract": "...",
      "year": 2003,
      "author_names": ["..."],
      "session_info": { "...": "..." }
    }
  ]
}