---
title: "Any Site API / /nytimes/articles/search"
description: "Anysite tool anysite-api-nytimes-articles-search on looot: input fields, $0.00072 per result, output shape, and code to run it with curl, JavaScript or Python."
sidebar:
  hidden: true
---

{/* Generated by scripts/generate-api-reference.mjs from data/api-reference.json. Do not edit. */}

Search everything The New York Times has published since 1851, news and opinion articles, videos, interactives, slideshows, audio, recipes, The Athletic and Wirecutter pieces, paid posts and card decks. Filter by kind of item, section, publication day range and language edition, and order by relevance, newest or oldest. Each result carries headline, summary, kicker, authors, section, topic tags, lead image and publication times. **Price:** 20 credits per 100 results

- **Tool id:** `anysite-api-nytimes-articles-search`
- **Provider:** [Anysite](/providers/anysite)
- **Job:** [Search api nytimes articles](/reference/jobs/api-nytimes-articles-search) (`api.nytimes.articles.search`)
- **Price:** $0.00072 per result. A call that fails at the provider costs $0.

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | integer | yes | Max number of results to return |
| `end_date` | string | no |   |
| `keyword` | string | no | Full-text phrase to search for; leave it empty to browse by filters alone. Example: "ukraine" |
| `language` | string | no |   |
| `section` | string | no |   |
| `sort` | string | no |   |
| `start_date` | string | no |   |
| `timeout` | integer | no | Max scrapping execution timeout (in seconds) |
| `types` | array | no | Kinds of published item to include |
| `x-request-id` | string | no |   |

## Output

The run's `result` holds the provider's answer. Signed in, `looot inspect anysite-api-nytimes-articles-search` prints its fields.

## Run it

Every call needs your API token in `LOOOT_TOKEN`; [Sign in](/get-started/sign-in#use-the-token-in-scripts-and-agents) shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With `wait: 30` the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll `GET /v1/runs/<runId>`.

Example input with placeholder values:

<CodeGroup>

```bash curl
curl -X POST "https://api.looot.ai/v1/runs" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endpointId":"anysite-api-nytimes-articles-search","input":{"count":1,"keyword":"ukraine"},"wait":30}'
```

```js JavaScript
const response = await fetch("https://api.looot.ai/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    endpointId: "anysite-api-nytimes-articles-search",
    input: {
      count: 1,
      keyword: "ukraine",
    },
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
```

```python Python
import os
import uuid

import requests

response = requests.post(
    "https://api.looot.ai/v1/runs",
    headers={
        "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpointId": "anysite-api-nytimes-articles-search",
        "input": {
            "count": 1,
            "keyword": "ukraine",
        },
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))
```

</CodeGroup>

To let looot pick among every provider of this job instead, send `job:api.nytimes.articles.search` as `endpointId`; see [the job page](/reference/jobs/api-nytimes-articles-search).