# Public API reference

## Overview

The SEO4Ajax public API allows you to retrieve captures and sitemaps of your sites. It is designed to be used by your HTTP server (e.g. Apache, Nginx or IIS) in order to easily proxy bot requests of such resources.

## Retrieve captures

#### Definition

```
GET https://api.seo4ajax.com/{site-token}/{resource}
```

#### Arguments

- **site-token**  
  required The unique ID identifying the site on SEO4Ajax.  
- **resource**  
  optional, default to / The requested resource, composed of the path and query string.

#### Returns

The HTML content corresponding to the resource, captured by SEO4Ajax.

#### Example request

```
curl "https://api.seo4ajax.com/1543f22a3065164f3ad932bf2defa231/any_Path?parameter=1"
```

## Retrieve sitemap(s)

#### Definition

```
GET https://api.seo4ajax.com/{site-token}/sitemap{index}.xml
```

#### Arguments

- **site-token**  
  required The unique ID identifying the site on SEO4Ajax.  
- **index**  
  optional When there are more than 50,000 URLs, sitemap files are paginated. sitemap.xml corresponds to the sitemap index and sitemap{index}.xml to the different paginated sitemaps. Otherwise, sitemap.xml is the sitemap of the site.

#### Returns

The XML sitemap or sitemap index file.

#### Example request

```
curl "https://api.seo4ajax.com/1543f22a3065164f3ad932bf2defa231/sitemap.xml"
```