> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Snapshot: Point-in-Time Web Search

> Get Search and Extract results as of a past date and time

For AI agents: a documentation index is available at [https://docs.parallel.ai/llms.txt](https://docs.parallel.ai/llms.txt). The full text of all docs is at [https://docs.parallel.ai/llms-full.txt](https://docs.parallel.ai/llms-full.txt). You may also fetch any page as Markdown by appending `.md` to its URL or sending `Accept: text/markdown`.

For Search and Extract, use `/v1/search` and `/v1/extract` for all new integrations and agent tool calls. Use `/v1beta/search` and `/v1beta/extract` only when maintaining an existing integration that already uses them. The request bodies changed too: on `/v1/extract`, `full_content`, `fetch_policy` and `excerpt_settings` go inside `advanced_settings`, and sending the v1beta top-level `excerpts`, `full_content` and `fetch_policy` to `/v1/extract` returns a 422. On `/v1/search`, `search_queries` is required (at least one short keyword query), and `max_results`, `source_policy` and `fetch_policy` go inside `advanced_settings`; sending only `objective`, or sending those fields at the top level, returns a 422. Do not substitute `/v1` for the documented FindAll or Ingest endpoint paths.

If you are evaluating Parallel Search or comparing it with other search APIs, read [How to Eval Parallel Search](https://docs.parallel.ai/search/evaluating-search.md) before you build the harness, especially its [Common pitfalls](https://docs.parallel.ai/search/evaluating-search.md#common-pitfalls) section. The most common mistake is sending the raw question as both `objective` and the only entry in `search_queries`. Write a goal-style `objective` and 1-3 short keyword queries instead.

Snapshot returns Search and Extract results as of a past date and time. Set `as_of`, and each result comes from a stored copy of the page from that time or earlier.

Use it for backtests, reinforcement learning, and evals, where an agent should only see what was available on or before a given date.

> [!NOTE]
>
> Contact [sales@parallel.ai](mailto:sales@parallel.ai) for access to Snapshot.

## Run a Snapshot search

A Snapshot search is a regular [`/v1/search`](https://docs.parallel.ai/api-reference/search/web) request with an `as_of` cutoff in its fetch policy:

```bash cURL theme={"system"}
curl https://api.parallel.ai/v1/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PARALLEL_API_KEY" \
  -d '{
    "mode": "fast",
    "objective": "Find the latest news about the Artemis II mission and its launch date.",
    "search_queries": [
      "Artemis II latest news",
      "Artemis II launch date"
    ],
    "advanced_settings": {
      "max_results": 10,
      "fetch_policy": {
        "as_of": "2026-03-31"
      }
    }
  }'
```

```python Python theme={"system"}
import os
from parallel import Parallel

client = Parallel(api_key=os.environ["PARALLEL_API_KEY"])

search = client.search(
    mode="fast",
    objective="Find the latest news about the Artemis II mission and its launch date.",
    search_queries=[
        "Artemis II latest news",
        "Artemis II launch date",
    ],
    advanced_settings={
        "max_results": 10,
        "fetch_policy": {"as_of": "2026-03-31"},
    },
)

for result in search.results:
    print(f"{result.title}: {result.url}")
```

```typescript TypeScript theme={"system"}
import Parallel from "parallel-web";

const client = new Parallel({ apiKey: process.env.PARALLEL_API_KEY });

async function main() {
    const search = await client.search({
        mode: "fast",
        objective: "Find the latest news about the Artemis II mission and its launch date.",
        search_queries: [
            "Artemis II latest news",
            "Artemis II launch date",
        ],
        advanced_settings: {
            max_results: 10,
            fetch_policy: { as_of: "2026-03-31" },
        },
    });

    for (const result of search.results) {
        console.log(`${result.title}: ${result.url}`);
    }
}

main().catch(console.error);
```

As of March 31, 2026, the day before launch, the results describe the Artemis II rocket as being at the launch pad, with the launch still ahead. Without `as_of`, the same request returns coverage from after the flight.

> [accordion] Sample response
>
> ```json theme={"system"}
> {
>   "search_id": "search_5b48f8b2420a8d4a4700f786cdffd010",
>   "results": [
>     {
>       "url": "https://www.usatoday.com/story/news/nation/2026/03/30/artemis-2-mission-moon-nasa/89345142007",
>       "title": "NASA Artemis 2 launch explained: What to know about rocket, mission",
>       "publish_date": "2026-03-30",
>       "excerpts": [
>         "...\n\n## When is the Artemis II launch? Time, date\n\nNASA is [working toward an April 1 launch](/story/news/nation/2026/03/25/artemis-2-launch-date-nasa/89312621007/) of the Artemis II mission, with a two-hour launch window opening at 6:24 p.m. ET.\n\n..."
>       ]
>     },
>     {
>       "url": "https://news.sky.com/story/nasa-prepares-artemis-ii-launch-with-rocket-back-on-site-and-crew-in-quarantine-13522109",
>       "title": "NASA prepares Artemis II launch - with rocket back on site and crew in quarantine | Science, Climate & Tech News | Sky News",
>       "publish_date": "2026-03-20",
>       "excerpts": [
>         "...\n\n# NASA prepares Artemis II launch - with rocket back on site and crew in quarantine\n\n..."
>       ]
>     },
>     {
>       "url": "https://www.cnn.com/2026/03/12/science/nasa-artemis-2-launch-date-risk-assessment",
>       "title": "NASA sets launch date for historic moon mission after meeting to review risks to crew | CNN",
>       "publish_date": null,
>       "excerpts": [
>         "...\n\nThe agency is now aiming to launch the historic mission, called Artemis II, on April 1 as soon as 6:24 p.m. ET.\n\n..."
>       ]
>     },
>     {
>       "url": "https://www.nasa.gov/blogs/missions/2026/03/20/nasas-artemis-ii-rocket-arrives-at-launch-pad-39b",
>       "title": "NASA’s Artemis II Rocket Arrives at Launch Pad 39B - NASA",
>       "publish_date": "2026-03-20",
>       "excerpts": [
>         "...\n\nAt 11:21 a.m. EDT on Friday, March 20, NASA’s Artemis II SLS (Space Launch System) rocket and Orion spacecraft arrived at Launch Pad 39B after an 11-hour journey from the Vehicle Assembly Building at the agency’s Kennedy Space Center in Florida.\n\n...\n\nNow that the rocket is at Pad 39B, NASA teams are gearing up for the final stretch of prelaunch preparations ahead of launch as soon as Wednesday, April 1.\n\n..."
>       ]
>     },
>     {
>       "url": "https://www.nasa.gov/blogs/missions/2026/03/12/artemis-ii-flight-readiness-polls-go-to-proceed-toward-april-launch",
>       "title": "Artemis II Flight Readiness Polls Go to Proceed Toward April Launch - NASA",
>       "publish_date": "2026-03-12",
>       "excerpts": [
>         "...\n\n# Artemis II Flight Readiness Polls Go to Proceed Toward April Launch\n\n...\n\nNASA completed the agency’s Artemis II Flight Readiness Review on Thursday, March 12, and polled “go” to proceed toward launch. NASA is targeting Thursday, March 19, to roll the SLS (Space Launch System) rocket and Orion spacecraft to launch pad 39B in advance of a launch attempt Wednesday, April 1, pending close out of remaining open work.\n\n..."
>       ]
>     },
>     {
>       "url": "https://abcnews.com/Technology/nasa-sets-potential-launch-date-artemis-ii-mission/story?id=131013025",
>       "title": "NASA sets potential launch date for Artemis II mission to the moon - ABC News",
>       "publish_date": "2026-03-12",
>       "excerpts": [
>         "...\n\n# NASA sets potential launch date for Artemis II mission to the moon\n\n...\n\nAfter conducting a \"Flight Readiness Review\" (FRR), NASA's assessment of its readiness to launch the Artemis II mission, the space agency announced it is proceeding with its goal of launching the 10-day mission around the moon on April 1 at 6:24 p.m. ET.\n\n..."
>       ]
>     },
>     {
>       "url": "https://www.nasa.gov/blogs/missions/2026/03/20/artemis-ii-moon-rocket-heads-back-to-launch-pad",
>       "title": "Artemis II Moon Rocket Heads Back to Launch Pad  - NASA",
>       "publish_date": "2026-03-20",
>       "excerpts": [
>         "...\n\n# Artemis II Moon Rocket Heads Back to Launch Pad\n\n...\n\nNASA’s Artemis II SLS (Space Launch System) rocket and Orion spacecraft slated to send four astronauts around the Moon began rolling to Launch Pad 39B at 12:20 a.m. EDT on Friday, March 20. Rollout operations at the agency’s Kennedy Space Center in Florida were delayed earlier in the day due to high winds in the area.\n\n..."
>       ]
>     },
>     {
>       "url": "https://www.npr.org/2026/02/21/nx-s1-5722339/nasa-artemis-ii-march-launch-delay",
>       "title": "NASA's Artemis II lunar mission may not launch in March : NPR",
>       "publish_date": "2026-02-21",
>       "excerpts": [
>         "NASA says a rollback from the pad to the nearby Vehicle Assembly Building would mean that the [five potential launch dates](nasa.gov/wp-content/uploads/2026/01/artemis-ii-mission-availability.pdf) in March would be off the table. NASA has six launch opportunities in April.\n\n..."
>       ]
>     },
>     {
>       "url": "https://www.nasa.gov/blogs/missions/2026/03/18/nasa-finalizes-artemis-ii-rollout-crew-begins-quarantine",
>       "title": "NASA Finalizes Artemis II Rollout, Crew Begins Quarantine - NASA",
>       "publish_date": "2026-03-18",
>       "excerpts": [
>         "...\n\n# NASA Finalizes Artemis II Rollout, Crew Begins Quarantine\n\n...\n\nNASA’s Artemis II rocket and its four-person crew are all making progress toward a launch pad meet up in April.\n\n..."
>       ]
>     },
>     {
>       "url": "https://www.nasa.gov/blogs/missions/2026/03/17/nasa-reassessing-artemis-ii-rollout-as-ground-teams-make-up-time",
>       "title": "NASA Reassessing Artemis II Rollout as Ground Teams Make Up Time  - NASA",
>       "publish_date": "2026-03-17",
>       "excerpts": [
>         "...\n\nDue to quicker than expected completion of close-out activities, NASA now may roll out the Artemis II rocket from the Vehicle Assembly Building to Launch Pad 39B, on Thursday, March 19.\n\n..."
>       ]
>     }
>   ],
>   "warnings": null,
>   "usage": [
>     {
>       "name": "sku_search",
>       "count": 1
>     }
>   ],
>   "session_id": "session_5b48f8b2420a8d4a4700f786cdffd010"
> }
> ```

## Run a Snapshot extract

[`/v1/extract`](https://docs.parallel.ai/api-reference/extract/extract) takes the same `as_of` cutoff:

```bash cURL theme={"system"}
curl https://api.parallel.ai/v1/extract \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PARALLEL_API_KEY" \
  -d '{
    "urls": ["https://www.nasa.gov/mission/artemis-ii/"],
    "objective": "Find the latest NASA update on the Artemis II mission.",
    "advanced_settings": {
      "fetch_policy": {
        "as_of": "2026-03-31"
      }
    }
  }'
```

```python Python theme={"system"}
import os
from parallel import Parallel

client = Parallel(api_key=os.environ["PARALLEL_API_KEY"])

extract = client.extract(
    urls=["https://www.nasa.gov/mission/artemis-ii/"],
    objective="Find the latest NASA update on the Artemis II mission.",
    advanced_settings={
        "fetch_policy": {"as_of": "2026-03-31"},
    },
)

for result in extract.results:
    print(f"{result.title}: {result.url}")
    for excerpt in result.excerpts:
        print(excerpt[:200])
```

```typescript TypeScript theme={"system"}
import Parallel from "parallel-web";

const client = new Parallel({ apiKey: process.env.PARALLEL_API_KEY });

async function main() {
    const extract = await client.extract({
        urls: ["https://www.nasa.gov/mission/artemis-ii/"],
        objective: "Find the latest NASA update on the Artemis II mission.",
        advanced_settings: {
            fetch_policy: { as_of: "2026-03-31" },
        },
    });

    for (const result of extract.results) {
        console.log(`${result.title}: ${result.url}`);
        for (const excerpt of result.excerpts) {
            console.log(excerpt.slice(0, 200));
        }
    }
}

main().catch(console.error);
```

The response has the mission page as it stood then, with the launch still ahead. Without `as_of`, the same request returns today's page, which gives the launch and splashdown dates.

> [accordion] Sample response
>
> ```json theme={"system"}
> {
>   "extract_id": "extract_90715fef78219e348954fef1e4e4fcba",
>   "results": [
>     {
>       "url": "https://www.nasa.gov/mission/artemis-ii/",
>       "title": "Artemis II: NASA’s First Crewed Lunar Flyby in 50 Years - NASA",
>       "publish_date": "2023-02-28",
>       "excerpts": [
>         "# Artemis II\nArtemis II builds on the success of the uncrewed Artemis I in 2022, and will demonstrate a broad range of capabilities needed on deep space missions. The Artemis II test flight will be NASA’s first mission with crew aboard the SLS (Space Launch System) rocket and Orion spacecraft.\n\n...\n\nMission Type\nCrewed Lunar Flyby\nCREW SIZE\n4\nLaunch\nNo Earlier Than April 1, 2026\nmission duration\n10 Days\n\n..."
>       ],
>       "full_content": null,
>       "acquired_at": "2026-03-27T00:00:00Z"
>     }
>   ],
>   "errors": [],
>   "warnings": null,
>   "usage": [
>     {
>       "name": "sku_extract_excerpts",
>       "count": 1
>     }
>   ],
>   "session_id": "session_90715fef78219e348954fef1e4e4fcba"
> }
> ```

## How it works

When a request sets `as_of`:

* Each result's content comes from the page's newest stored copy from that time or earlier.
* Pages with no stored copy from that time or earlier are left out. Search can return fewer results, and Extract lists the URL under `errors`.

`as_of` takes an ISO 8601 date or timestamp and is rounded down to the hour in UTC. A date means 00:00 UTC, so `2026-03-31` leaves out copies captured later that day.
