📡

ConfTracker API

Developer documentation & data endpoints for ConfTracker

⬅️ Back to Main Dashboard

Overview

Welcome to the ConfTracker API. This API provides programmatic access to our aggregated academic conference deadline tracking data. You can query the catalog of conferences, filter by publishers (ACM, AIS, IEEE, Elsevier, Springer, Wiley), filter by CORE quality ratings, and search for venues matching your abstract using semantic similarity.

All responses are returned as structured JSON objects. Dates are formatted in ISO-8601 standard format (YYYY-MM-DD).

Authentication

Currently, all read-only endpoints in the ConfTracker API are open and do not require authentication or API keys.

Rate Limiting
Please use the API responsibly. Do not run heavy scraping loops directly on the API endpoints. For bulk offline processing, fetch all conferences once using the /api/json/ endpoint.
GET /api/json/

Get All Conferences

Returns a list of all active conferences matching the specified filters. By default, it returns all active conferences (including both past and upcoming deadlines).

Query Parameters

Parameter Type Required Description
publisher string Optional Filter by publisher. Options: "all", "ACM", "AIS", "IEEE", "Springer", "Elsevier", "Wiley", "Other". Default is "all".
core string Optional Filter by CORE rating. Can be a comma-separated list of ratings to filter by multiple simultaneously. Options: "all", "A*", "A", "B", "C", "Unranked". Default is "all".
upcoming boolean Optional If "true", filters out conferences whose submission deadlines are in the past. Default is "false".

Example Response

JSON 
{
  "conferences": [
    {
      "id": 24,
      "name": "ACM Conference on Human Factors in Computing Systems",
      "acronym": "CHI",
      "publisher": "ACM",
      "core_rating": "A*",
      "deadline": "2026-09-15",
      "deadline_display": "Sep 15, 2026",
      "days_left": 97,
      "abstract_deadline": "2026-09-08",
      "location": "Yokohama, Japan",
      "website": "https://chi2027.acm.org/",
      "description": "Premier international conference on Human-Computer Interaction.",
      "topics": "HCI, UI, UX, interaction, computing",
      "tags": "tilmans_favorite"
    }
  ],
  "count": 1
}
GET /api/conferences/

Get Upcoming Conferences

Similar to /api/json/ but optimized for frontend list views, returning upcoming conferences only (upcoming=true) by default.

Query parameters and response format match /api/json/.

POST /api/recommend/

Get Recommendations

Submits a paper abstract or description to search for matching conference venues based on keywords and description similarity.

JSON Payload Schema

Field Type Required Description
query string Required The text of the abstract, paper title, or descriptive research keywords.
publisher string Optional Filter results by publisher. Options: "all", "ACM", etc. Default is "all".
core string Optional Filter results by specific CORE ratings. Can be a comma-separated list to filter by multiple ratings. Options: "all", "A*", "A", "B", "C", "Unranked". Default is "all".
top_k integer Optional Number of recommended venues to return (max 30). Default is 10.

Example Request

POST Request Body 
{
  "query": "A machine learning framework for predictive maintenance of database instances.",
  "publisher": "all",
  "core": "A"
}
GET /api/last-refresh/

Get Last Scraper Execution

Retrieves metadata regarding the most recent scraper pipeline execution, including timestamps and statistics on new or updated conferences.

Example Response

JSON 
{
  "refreshed_at": "2026-06-10T15:10:42.123Z",
  "conferences_added": 3,
  "conferences_updated": 12,
  "status": "success",
  "message": "Scraper run finished. Added 3, updated 12."
}
POST /api/refresh/

Refresh All Conference Data

Triggers a full data refresh from all 6 sources: ai-deadlines, a-nau-deadlines, sec-deadlines, se-deadlines, ccfddl, and conferenceindex.org. Updates deadlines, locations, websites, and conference dates for all tracked conferences. Also accepts GET requests.

⚠️ This endpoint takes 30–60 seconds to complete as it fetches from multiple external sources.

Example Response

JSON 
{
  "status": "success",
  "added": 99,
  "updated": 484,
  "message": "Scraped 880 conferences: 99 added, 484 updated, 298 skipped."
}
POST /api/refresh-core/

Refresh CORE Ratings

Re-scrapes CORE rankings for all active conferences from portal.core.edu.au. Rate-limited to 1 request/second to respect the CORE portal. Also accepts GET requests.

⚠️ This endpoint can take several minutes depending on the number of active conferences (currently ~600, so ~10 minutes).

Example Response

JSON 
{
  "status": "success",
  "checked": 480,
  "updated": 12,
  "message": "CORE refresh complete: checked 480/506 conferences, 12 ratings updated."
}

Interactive API Playground

Configure parameters below to query the live database API. Code snippets for Python and JavaScript will update automatically to match your selections.

/api/json/
javascript 
loading...