WEBAPI

CONNECTIONS

Default

NYT API

Unofficial API docs for NYT Connections puzzle data. Use GET /svc/connections/v2/{date}.json to fetch daily puzzle JSON, with date availability notes, sample responses, error handling, caching, and best practices.

Unofficial NYT Connections API Documentation | Daily Puzzle JSON by Date

Production

<h1 class="slate-h1 " ><strong class="slate-bold">NYT Connections API Documentation</strong></h1><h2 class="slate-h2 " >Overview</h2><p class="slate-p " >This API documentation is provided by <a href="https://www.nytgamehint.com/connections" target="_blank">a website offering daily Connections hints</a> to help developers access NYT Connections game data. Please note that this website provides the documentation for convenience only and is not the official API provider.</p><h2 class="slate-h2 " >Endpoint</h2><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">HTTP</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-http keep-markup drop-tokens"><div class="slate-code_line">GET https://www.nytimes.com/svc/connections/v2/{date}.json</div></code></pre></div><h2 class="slate-h2 " >Parameters</h2><p class="slate-p " ></p><h3 class="slate-h3 " >Date Constraints</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Earliest Date</strong>: <code class="slate-code">2023-06-12</code> (the official launch date of NYT Connections)</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Future Dates</strong>: The API may return data for future dates if the NYT team has pre-uploaded puzzles to their server</div></li></ul><h2 class="slate-h2 " >Important Notes on Future Data Availability</h2><p class="slate-p " >The New York Times typically uploads Connections puzzles several days or even weeks in advance.  The availability of future puzzle data depends entirely on their editorial team&apos;s workflow and upload schedule:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Sometimes you may only access tomorrow&apos;s or the day after tomorrow&apos;s data</div></li><li class="slate-li " ><div style="position:relative">Other times you might be able to retrieve data up to a month in advance</div></li><li class="slate-li " ><div style="position:relative">There is no strict automated rule for how far in advance puzzles are uploaded</div></li></ul><h3 class="slate-h3 " >Discovering the Upper Boundary of Available Data</h3><p class="slate-p " >To find the latest available puzzle date, implement a loop that:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Start with tomorrow&apos;s date</div></li><li class="slate-li " ><div style="position:relative">Increment the date by one day for each request</div></li><li class="slate-li " ><div style="position:relative">If the response returns <code class="slate-code">200</code> with <code class="slate-code">status: &quot;OK&quot;</code> → data exists, save it and continue</div></li><li class="slate-li " ><div style="position:relative">If the response returns <code class="slate-code">404 Not Found</code> → you&apos;ve reached the boundary of currently uploaded data</div></li></ol><p class="slate-p " >This method allows you to determine the most recent puzzle date available on the server.</p><h2 class="slate-h2 " >Request Example</h2><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden">GET https://www.nytimes.com/svc/connections/v2/2025-12-10.json </textarea><code class="language-plainText keep-markup drop-tokens"></code></pre></div><h2 class="slate-h2 " >Response Format</h2><h3 class="slate-h3 " >Success Response</h3><p class="slate-p " ><strong class="slate-bold">HTTP Status</strong>:  <code class="slate-code">200 OK</code></p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line">{</div><div class="slate-code_line">  &quot;status&quot;: &quot;OK&quot;,</div><div class="slate-code_line">  &quot;id&quot;: 1,</div><div class="slate-code_line">  &quot;print_date&quot;: &quot;2023-06-12&quot;,</div><div class="slate-code_line">  &quot;editor&quot;: &quot;Wyna Liu&quot;,</div><div class="slate-code_line">  &quot;categories&quot;: [</div><div class="slate-code_line">    {</div><div class="slate-code_line">      &quot;title&quot;: &quot;WET WEATHER&quot;,</div><div class="slate-code_line">      &quot;cards&quot;: [</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;HAIL&quot;,</div><div class="slate-code_line">          &quot;position&quot;:  9</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;RAIN&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 11</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;SLEET&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 12</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;SNOW&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 0</div><div class="slate-code_line">        }</div><div class="slate-code_line">      ]</div><div class="slate-code_line">    },</div><div class="slate-code_line">    {</div><div class="slate-code_line">      &quot;title&quot;: &quot;NBA TEAMS&quot;,</div><div class="slate-code_line">      &quot;cards&quot;:  [</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;BUCKS&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 6</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;:  &quot;HEAT&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 4</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;JAZZ&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 8</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;NETS&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 15</div><div class="slate-code_line">        }</div><div class="slate-code_line">      ]</div><div class="slate-code_line">    },</div><div class="slate-code_line">    {</div><div class="slate-code_line">      &quot;title&quot;:  &quot;KEYBOARD KEYS&quot;,</div><div class="slate-code_line">      &quot;cards&quot;: [</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;OPTION&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 10</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;RETURN&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 7</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;:  &quot;SHIFT&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 2</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;TAB&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 5</div><div class="slate-code_line">        }</div><div class="slate-code_line">      ]</div><div class="slate-code_line">    },</div><div class="slate-code_line">    {</div><div class="slate-code_line">      &quot;title&quot;: &quot;PALINDROMES&quot;,</div><div class="slate-code_line">      &quot;cards&quot;: [</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;KAYAK&quot;,</div><div class="slate-code_line">          &quot;position&quot;:  3</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;LEVEL&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 1</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;MOM&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 14</div><div class="slate-code_line">        },</div><div class="slate-code_line">        {</div><div class="slate-code_line">          &quot;content&quot;: &quot;RACECAR&quot;,</div><div class="slate-code_line">          &quot;position&quot;: 13</div><div class="slate-code_line">        }</div><div class="slate-code_line">      ]</div><div class="slate-code_line">    }</div><div class="slate-code_line">  ]</div><div class="slate-code_line">}</div></code></pre></div><h4 class="slate-h4 " >Response Fields</h4><p class="slate-p " ></p><h3 class="slate-h3 " >Error Response</h3><p class="slate-p " ><strong class="slate-bold">HTTP Status</strong>: <code class="slate-code">404 Not Found</code> (or other error status)</p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line">{</div><div class="slate-code_line">  &quot;status&quot;: &quot;ERROR&quot;,</div><div class="slate-code_line">  &quot;errors&quot;: [</div><div class="slate-code_line">    &quot;Not Found&quot;</div><div class="slate-code_line">  ],</div><div class="slate-code_line">  &quot;results&quot;: []</div><div class="slate-code_line">}</div></code></pre></div><h4 class="slate-h4 " >Error Response Fields</h4><p class="slate-p " ></p><h2 class="slate-h2 " >Response Validation</h2><p class="slate-p " >To determine if the request was successful, check if the <code class="slate-code">status</code> field equals <code class="slate-code">&quot;OK&quot;</code>.</p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-javascript keep-markup drop-tokens"><div class="slate-code_line">if (response.status === &quot;OK&quot;) {</div><div class="slate-code_line">  // Process puzzle data</div><div class="slate-code_line">} else {</div><div class="slate-code_line">  // Handle error</div><div class="slate-code_line">}</div></code></pre></div><h2 class="slate-h2 " >Usage Examples</h2><h3 class="slate-h3 " >Fetching Today&apos;s Puzzle</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-javascript keep-markup drop-tokens"><div class="slate-code_line">const today = new Date().toISOString().split(&apos;T&apos;)[0]; // Format: yyyy-MM-dd</div><div class="slate-code_line">const url = `https://www.nytimes.com/svc/connections/v2/${today}.json`;</div><div class="slate-code_line"></div><div class="slate-code_line">fetch(url)</div><div class="slate-code_line">  .then(response =&gt; response.json())</div><div class="slate-code_line">  .then(data =&gt; {</div><div class="slate-code_line">    if (data.status === &quot;OK&quot;) {</div><div class="slate-code_line">      console.log(&quot;Puzzle categories:&quot;, data.categories);</div><div class="slate-code_line">    } else {</div><div class="slate-code_line">      console.error(&quot;Error:&quot;, data.errors);</div><div class="slate-code_line">    }</div><div class="slate-code_line">  });</div></code></pre></div><h3 class="slate-h3 " >Finding the Latest Available Puzzle</h3><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-javascript keep-markup drop-tokens"><div class="slate-code_line">async function findLatestPuzzle() {</div><div class="slate-code_line">  let currentDate = new Date();</div><div class="slate-code_line">  currentDate.setDate(currentDate. getDate() + 1); // Start with tomorrow</div><div class="slate-code_line">  </div><div class="slate-code_line">  while (true) {</div><div class="slate-code_line">    const dateStr = currentDate.toISOString().split(&apos;T&apos;)[0];</div><div class="slate-code_line">    const url = `https://www.nytimes.com/svc/connections/v2/${dateStr}.json`;</div><div class="slate-code_line">    </div><div class="slate-code_line">    try {</div><div class="slate-code_line">      const response = await fetch(url);</div><div class="slate-code_line">      const data = await response.json();</div><div class="slate-code_line">      </div><div class="slate-code_line">      if (data.status !== &quot;OK&quot;) {</div><div class="slate-code_line">        // Found the boundary</div><div class="slate-code_line">        currentDate.setDate(currentDate. getDate() - 1);</div><div class="slate-code_line">        return currentDate.toISOString().split(&apos;T&apos;)[0];</div><div class="slate-code_line">      }</div><div class="slate-code_line">      </div><div class="slate-code_line">      // Move to next day</div><div class="slate-code_line">      currentDate. setDate(currentDate.getDate() + 1);</div><div class="slate-code_line">    } catch (error) {</div><div class="slate-code_line">      currentDate.setDate(currentDate. getDate() - 1);</div><div class="slate-code_line">      return currentDate.toISOString().split(&apos;T&apos;)[0];</div><div class="slate-code_line">    }</div><div class="slate-code_line">  }</div><div class="slate-code_line">}</div></code></pre></div><h2 class="slate-h2 " >Rate Limiting and Best Practices</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Be respectful of the NYT servers when making requests</div></li><li class="slate-li " ><div style="position:relative">Implement appropriate caching mechanisms to avoid unnecessary repeated requests</div></li><li class="slate-li " ><div style="position:relative">Consider adding delays between requests when discovering the data boundary</div></li><li class="slate-li " ><div style="position:relative">Handle errors gracefully and implement retry logic for network failures</div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><strong class="slate-bold">Disclaimer</strong>: This is an unofficial API documentation.  The API is provided by The New York Times and may change without notice. Always ensure your usage complies with The New York Times&apos; terms of service.</p><p class="slate-p " ></p>

 to help developers access NYT Connections game data. Please note that this website provides the documentation for convenience only and is not the official API provider.

Important Notes on Future Data Availability

The New York Times typically uploads Connections puzzles several days or even weeks in advance.  The availability of future puzzle data depends entirely on their editorial team's workflow and upload schedule:

Discovering the Upper Boundary of Available Data

To find the latest available puzzle date, implement a loop that:

This method allows you to determine the most recent puzzle date available on the server.

To determine if the request was successful, check if the 

: This is an unofficial API documentation.  The API is provided by The New York Times and may change without notice. Always ensure your usage complies with The New York Times' terms of service.

Sections