📡

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
}
🛠️ Try It Out
/api/json/
GET /api/conferences/

Get Upcoming Conferences

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

🛠️ Try It Out
/api/conferences/
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"
}
🛠️ Try It Out
/api/recommend/ [POST]
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."
}
🛠️ Try It Out
/api/last-refresh/
POST /api/discover/

Discover New Conferences

Scans recent conference deadlines on WikiCFP to discover new events. It automatically adds conferences matching our tracked list of publishers, as well as conferences from other publishers if they hold a CORE rating of B or above (registered under the publisher tag "Other"). Also accepts GET requests.

Example Response

JSON 
{
  "status": "success",
  "discovered": 2,
  "already_known": 180,
  "message": "Parsed CCFDDL deadlines XML feed: 2 new conferences discovered, 180 already tracked, 14 not relevant (C rating or unranked non-tracked publishers)."
}
🛠️ Try It Out
/api/discover/
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."
}
⚙️ Trigger Action
⚠️ Warning: This runs the full web scraper pipeline. It executes real network requests to external conference portals and can take 30-60 seconds to finish.
/api/refresh/ [POST]
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."
}
⚙️ Trigger Action
🚨 Critical Warning: This re-scrapes the CORE portal rankings for all active conferences. To respect portal rate limits, it runs slowly and takes up to 10 minutes.
/api/refresh-core/ [POST]

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...