Skip to Content

Endpoints

Collections

Artworks

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /artworks

A list of all artworks sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • artist_pivots
    • catalogue_pivots
    • dates
    • place_pivots
    • sites

Example request: https://aggregator-data.artic.edu/api/v1/artworks?limit=2
Example output:

{
    "pagination": {
        "total": 111777,
        "limit": 2,
        "offset": 0,
        "total_pages": 55889,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/artworks?page=2&limit=2"
    },
    "data": [
        {
            "id": 2093,
            "api_model": "artworks",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artworks/2093",
            "is_boosted": false,
            "title": "Shawl",
            "alt_titles": null,
            ...
        },
        {
            "id": 224867,
            "api_model": "artworks",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artworks/224867",
            "is_boosted": false,
            "title": "Drawing Without Paper 85.22 (Dibujo sin papel 85.22)",
            "alt_titles": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /artworks/search

Search artworks data in the aggregator. Artworks in the groups of essentials are boosted so they'll show up higher in results.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/artworks/search?q=monet
Example output:

{
    "preference": null,
    "pagination": {
        "total": 292,
        "limit": 10,
        "offset": 0,
        "total_pages": 30,
        "current_page": 1
    },
    "data": [
        {
            "_score": 246.98303,
            "thumbnail": {
                "alt_text": "A work made of oil on canvas.",
                "width": null,
                "type": "iiif",
                "url": "https://www.artic.edu/iiif/2/5d2717cc-c619-fd84-49c4-62409bb1c04c",
                "lqip": null,
                "height": null
            },
            "api_model": "artworks",
            "is_boosted": true,
            "api_link": "https://aggregator-data.artic.edu/api/v1/artworks/16568",
            "id": 16568,
            "title": "Water Lilies",
            "timestamp": "2020-02-21T03:03:19-06:00"
        },
        {
            "_score": 228.8306,
            "thumbnail": {
                "alt_text": "A work made of oil on canvas.",
                "width": null,
                "type": "iiif",
                "url": "https://www.artic.edu/iiif/2/ddae7b18-6c67-bfe7-f270-c999655b08c7",
                "lqip": null,
                "height": null
            },
            "api_model": "artworks",
            "is_boosted": true,
            "api_link": "https://aggregator-data.artic.edu/api/v1/artworks/16571",
            "id": 16571,
            "title": "Arrival of the Normandy Train, Gare Saint-Lazare",
            "timestamp": "2020-02-21T03:03:19-06:00"
        },
        {
            "_score": 226.30798,
            "thumbnail": {
                "alt_text": "A work made of oil on canvas.",
                "width": null,
                "type": "iiif",
                "url": "https://www.artic.edu/iiif/2/691c69c1-221a-1faf-14ea-7bc0c0a05fe2",
                "lqip": null,
                "height": null
            },
            "api_model": "artworks",
            "is_boosted": true,
            "api_link": "https://aggregator-data.artic.edu/api/v1/artworks/64818",
            "id": 64818,
            "title": "Stacks of Wheat (End of Summer)",
            "timestamp": "2020-02-21T03:14:28-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /artworks/{id}

A single artwork by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/artworks/2093?limit=2
Example output:

{
    "data": {
        "id": 2093,
        "api_model": "artworks",
        "api_link": "https://aggregator-data.artic.edu/api/v1/artworks/2093",
        "is_boosted": false,
        "title": "Shawl",
        "alt_titles": null,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Agents

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /agents

A list of all agents sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • sites

Example request: https://aggregator-data.artic.edu/api/v1/agents?limit=2
Example output:

{
    "pagination": {
        "total": 13532,
        "limit": 2,
        "offset": 0,
        "total_pages": 6766,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/agents?page=2&limit=2"
    },
    "data": [
        {
            "id": 29405,
            "api_model": "agents",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agents/29405",
            "title": "Jack Youngerman",
            "sort_title": "Youngerman, Jack",
            "alt_titles": null,
            ...
        },
        {
            "id": 5944,
            "api_model": "agents",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agents/5944",
            "title": "Hanne Darboven",
            "sort_title": "Darboven, Hanne",
            "alt_titles": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /agents/search

Search agents data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/agents/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 13531,
        "limit": 10,
        "offset": 0,
        "total_pages": 1354,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "agents",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agents/2086",
            "id": 2086,
            "title": "Billy Al Bengston",
            "timestamp": "2020-02-21T03:50:00-06:00"
        },
        {
            "_score": 1,
            "api_model": "agents",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agents/2102",
            "id": 2102,
            "title": "Edward Herbert Bennett",
            "timestamp": "2020-02-21T03:50:00-06:00"
        },
        {
            "_score": 1,
            "api_model": "agents",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agents/2104",
            "id": 2104,
            "title": "Henry Hamilton Bennett",
            "timestamp": "2020-02-21T03:50:00-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /agents/{id}

A single agent by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/agents/29405?limit=2
Example output:

{
    "data": {
        "id": 29405,
        "api_model": "agents",
        "api_link": "https://aggregator-data.artic.edu/api/v1/agents/29405",
        "title": "Jack Youngerman",
        "sort_title": "Youngerman, Jack",
        "alt_titles": null,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Places

The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.

GET /places

A list of all places sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/places?limit=2
Example output:

{
    "pagination": {
        "total": 3925,
        "limit": 2,
        "offset": 0,
        "total_pages": 1963,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/places?page=2&limit=2"
    },
    "data": [
        {
            "id": -2813,
            "api_model": "places",
            "api_link": "https://aggregator-data.artic.edu/api/v1/places/-2813",
            "title": "Darvel",
            "type": "No location",
            "last_updated_source": "2020-01-28T11:10:49-06:00",
            ...
        },
        {
            "id": 22629,
            "api_model": "places",
            "api_link": "https://aggregator-data.artic.edu/api/v1/places/22629",
            "title": "Korhogo, D\u00e9partement de",
            "type": "No location",
            "last_updated_source": "2019-12-03T09:41:53-06:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
        "license_links": [
            "https://www.artic.edu/terms",
            "https://creativecommons.org/licenses/by/4.0/"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /places/search

Search places data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/places/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 3925,
        "limit": 10,
        "offset": 0,
        "total_pages": 393,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://aggregator-data.artic.edu/api/v1/places/-2147483613",
            "id": -2147483613,
            "title": "Peoria",
            "timestamp": "2020-02-21T04:11:09-06:00"
        },
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://aggregator-data.artic.edu/api/v1/places/-2147483581",
            "id": -2147483581,
            "title": "Askov",
            "timestamp": "2020-02-21T04:11:09-06:00"
        },
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://aggregator-data.artic.edu/api/v1/places/-2147483534",
            "id": -2147483534,
            "title": "Z\u00fcrich",
            "timestamp": "2020-02-21T04:11:09-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
        "license_links": [
            "https://www.artic.edu/terms",
            "https://creativecommons.org/licenses/by/4.0/"
        ],
        "version": "1.0-rc10"
    }
}

GET /places/{id}

A single place by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/places/-2813?limit=2
Example output:

{
    "data": {
        "id": -2813,
        "api_model": "places",
        "api_link": "https://aggregator-data.artic.edu/api/v1/places/-2813",
        "title": "Darvel",
        "type": "No location",
        "last_updated_source": "2020-01-28T11:10:49-06:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
        "license_links": [
            "https://www.artic.edu/terms",
            "https://creativecommons.org/licenses/by/4.0/"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Galleries

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /galleries

A list of all galleries sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/galleries?limit=2
Example output:

{
    "pagination": {
        "total": 180,
        "limit": 2,
        "offset": 0,
        "total_pages": 90,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/galleries?page=2&limit=2"
    },
    "data": [
        {
            "id": 2705,
            "api_model": "galleries",
            "api_link": "https://aggregator-data.artic.edu/api/v1/galleries/2705",
            "title": "Gallery 59",
            "type": "AIC Gallery",
            "is_closed": true,
            ...
        },
        {
            "id": 2706,
            "api_model": "galleries",
            "api_link": "https://aggregator-data.artic.edu/api/v1/galleries/2706",
            "title": "Gallery 58",
            "type": "AIC Gallery",
            "is_closed": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /galleries/search

Search galleries data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/galleries/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 180,
        "limit": 10,
        "offset": 0,
        "total_pages": 18,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "galleries",
            "api_link": "https://aggregator-data.artic.edu/api/v1/galleries/2",
            "id": 2,
            "title": "East Garden at Columbus Drive",
            "timestamp": "2020-02-21T04:11:12-06:00"
        },
        {
            "_score": 1,
            "api_model": "galleries",
            "api_link": "https://aggregator-data.artic.edu/api/v1/galleries/346",
            "id": 346,
            "title": "Stock Exchange Trading Room",
            "timestamp": "2020-02-21T04:11:12-06:00"
        },
        {
            "_score": 1,
            "api_model": "galleries",
            "api_link": "https://aggregator-data.artic.edu/api/v1/galleries/2705",
            "id": 2705,
            "title": "Gallery 59",
            "timestamp": "2020-02-21T04:11:12-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /galleries/{id}

A single gallery by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/galleries/2706?limit=2
Example output:

{
    "data": {
        "id": 2706,
        "api_model": "galleries",
        "api_link": "https://aggregator-data.artic.edu/api/v1/galleries/2706",
        "title": "Gallery 58",
        "type": "AIC Gallery",
        "is_closed": true,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Exhibitions

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /exhibitions

A list of all exhibitions sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • artworks
    • sites

Example request: https://aggregator-data.artic.edu/api/v1/exhibitions?limit=2
Example output:

{
    "pagination": {
        "total": 6349,
        "limit": 2,
        "offset": 0,
        "total_pages": 3175,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/exhibitions?page=2&limit=2"
    },
    "data": [
        {
            "id": 2945,
            "api_model": "exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/exhibitions/2945",
            "title": "Shockingly Mad: Henry Fuseli and the Art of Drawing",
            "is_featured": false,
            "is_published": true,
            ...
        },
        {
            "id": 6264,
            "api_model": "exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/exhibitions/6264",
            "title": "Gods and (Super)heroes: Drawing in the Age of Revolution",
            "is_featured": false,
            "is_published": false,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /exhibitions/search

Search exhibitions data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/exhibitions/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 6349,
        "limit": 10,
        "offset": 0,
        "total_pages": 635,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/exhibitions/1321",
            "id": 1321,
            "title": "Souvenirs of the Barbizon: Photographs, Paintings, and Works on Paper",
            "timestamp": "2020-02-21T04:11:22-06:00"
        },
        {
            "_score": 1,
            "api_model": "exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/exhibitions/1332",
            "id": 1332,
            "title": "Capturing the Sublime: Italian Drawings of the Renaissance and Baroque",
            "timestamp": "2020-02-21T04:11:22-06:00"
        },
        {
            "_score": 1,
            "api_model": "exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/exhibitions/1333",
            "id": 1333,
            "title": "Bertrand Goldberg:  Architecture of Invention",
            "timestamp": "2020-02-21T04:11:22-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /exhibitions/{id}

A single exhibition by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/exhibitions/2945?limit=2
Example output:

{
    "data": {
        "id": 2945,
        "api_model": "exhibitions",
        "api_link": "https://aggregator-data.artic.edu/api/v1/exhibitions/2945",
        "title": "Shockingly Mad: Henry Fuseli and the Art of Drawing",
        "is_featured": false,
        "is_published": true,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Agent Types

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /agent-types

A list of all agent-types sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/agent-types?limit=2
Example output:

{
    "pagination": {
        "total": 26,
        "limit": 2,
        "offset": 0,
        "total_pages": 13,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/agent-types?page=2&limit=2"
    },
    "data": [
        {
            "id": 29,
            "api_model": "agent-types",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agent-types/29",
            "title": "Artist Collaborative",
            "last_updated_source": "2019-05-08T18:31:54-05:00",
            "last_updated": "2019-05-09T17:01:08-05:00",
            ...
        },
        {
            "id": 28,
            "api_model": "agent-types",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agent-types/28",
            "title": "Nonprofit",
            "last_updated_source": "2019-05-08T18:31:54-05:00",
            "last_updated": "2019-05-09T17:01:08-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /agent-types/{id}

A single agent-type by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/agent-types/29?limit=2
Example output:

{
    "data": {
        "id": 29,
        "api_model": "agent-types",
        "api_link": "https://aggregator-data.artic.edu/api/v1/agent-types/29",
        "title": "Artist Collaborative",
        "last_updated_source": "2019-05-08T18:31:54-05:00",
        "last_updated": "2019-05-09T17:01:08-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Agent Roles

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /agent-roles

A list of all agent-roles sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/agent-roles?limit=2
Example output:

{
    "pagination": {
        "total": 164,
        "limit": 2,
        "offset": 0,
        "total_pages": 82,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/agent-roles?page=2&limit=2"
    },
    "data": [
        {
            "id": 574,
            "api_model": "agent-roles",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agent-roles/574",
            "title": "File Transfer",
            "last_updated_source": "2019-05-08T19:05:12-05:00",
            "last_updated": "2019-05-09T17:01:07-05:00",
            ...
        },
        {
            "id": 573,
            "api_model": "agent-roles",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agent-roles/573",
            "title": "Imitator of",
            "last_updated_source": "2019-05-08T19:05:12-05:00",
            "last_updated": "2019-05-09T17:01:07-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /agent-roles/{id}

A single agent-role by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/agent-roles/574?limit=2
Example output:

{
    "data": {
        "id": 574,
        "api_model": "agent-roles",
        "api_link": "https://aggregator-data.artic.edu/api/v1/agent-roles/574",
        "title": "File Transfer",
        "last_updated_source": "2019-05-08T19:05:12-05:00",
        "last_updated": "2019-05-09T17:01:07-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Artwork Types

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /artwork-types

A list of all artwork-types sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/artwork-types?limit=2
Example output:

{
    "pagination": {
        "total": 43,
        "limit": 2,
        "offset": 0,
        "total_pages": 22,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/artwork-types?page=2&limit=2"
    },
    "data": [
        {
            "id": 47,
            "api_model": "artwork-types",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-types/47",
            "title": "Materials",
            "last_updated_source": "2019-10-07T11:53:19-05:00",
            "last_updated": "2019-10-07T11:56:21-05:00",
            ...
        },
        {
            "id": 46,
            "api_model": "artwork-types",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-types/46",
            "title": "Equipment",
            "last_updated_source": "2019-10-07T09:43:09-05:00",
            "last_updated": "2019-10-07T09:46:13-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /artwork-types/{id}

A single artwork-type by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/artwork-types/47?limit=2
Example output:

{
    "data": {
        "id": 47,
        "api_model": "artwork-types",
        "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-types/47",
        "title": "Materials",
        "last_updated_source": "2019-10-07T11:53:19-05:00",
        "last_updated": "2019-10-07T11:56:21-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Artwork Place Qualifiers

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /artwork-place-qualifiers

A list of all artwork-place-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/artwork-place-qualifiers?limit=2
Example output:

{
    "pagination": {
        "total": 13,
        "limit": 2,
        "offset": 0,
        "total_pages": 7,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/artwork-place-qualifiers?page=2&limit=2"
    },
    "data": [
        {
            "id": 53,
            "api_model": "artwork-place-qualifiers",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-place-qualifiers/53",
            "title": "Object Possibly made in",
            "last_updated_source": "2019-05-08T18:00:19-05:00",
            "last_updated": "2019-05-09T17:01:07-05:00",
            ...
        },
        {
            "id": 52,
            "api_model": "artwork-place-qualifiers",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-place-qualifiers/52",
            "title": "Object Probably made in",
            "last_updated_source": "2019-05-08T18:00:18-05:00",
            "last_updated": "2019-05-09T17:01:07-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /artwork-place-qualifiers/{id}

A single artwork-place-qualifier by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/artwork-place-qualifiers/53?limit=2
Example output:

{
    "data": {
        "id": 53,
        "api_model": "artwork-place-qualifiers",
        "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-place-qualifiers/53",
        "title": "Object Possibly made in",
        "last_updated_source": "2019-05-08T18:00:19-05:00",
        "last_updated": "2019-05-09T17:01:07-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Artwork Date Qualifiers

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /artwork-date-qualifiers

A list of all artwork-date-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/artwork-date-qualifiers?limit=2
Example output:

{
    "pagination": {
        "total": 31,
        "limit": 2,
        "offset": 0,
        "total_pages": 16,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/artwork-date-qualifiers?page=2&limit=2"
    },
    "data": [
        {
            "id": 62,
            "api_model": "artwork-date-qualifiers",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-date-qualifiers/62",
            "title": "Manufactured",
            "last_updated_source": "2019-05-08T21:59:24-05:00",
            "last_updated": "2019-05-09T17:01:07-05:00",
            ...
        },
        {
            "id": 61,
            "api_model": "artwork-date-qualifiers",
            "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-date-qualifiers/61",
            "title": "Delineated",
            "last_updated_source": "2019-05-08T21:59:24-05:00",
            "last_updated": "2019-05-09T17:01:07-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /artwork-date-qualifiers/{id}

A single artwork-date-qualifier by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/artwork-date-qualifiers/62?limit=2
Example output:

{
    "data": {
        "id": 62,
        "api_model": "artwork-date-qualifiers",
        "api_link": "https://aggregator-data.artic.edu/api/v1/artwork-date-qualifiers/62",
        "title": "Manufactured",
        "last_updated_source": "2019-05-08T21:59:24-05:00",
        "last_updated": "2019-05-09T17:01:07-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Catalogues

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /catalogues

A list of all catalogues sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/catalogues?limit=2
Example output:

{
    "pagination": {
        "total": 1101,
        "limit": 2,
        "offset": 0,
        "total_pages": 551,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/catalogues?page=2&limit=2"
    },
    "data": [
        {
            "id": 536,
            "api_model": "catalogues",
            "api_link": "https://aggregator-data.artic.edu/api/v1/catalogues/536",
            "title": "Chamberlain",
            "last_updated_source": "2019-10-15T09:35:50-05:00",
            "last_updated": "2019-10-15T09:36:17-05:00",
            ...
        },
        {
            "id": 535,
            "api_model": "catalogues",
            "api_link": "https://aggregator-data.artic.edu/api/v1/catalogues/535",
            "title": "Thuillier",
            "last_updated_source": "2019-07-23T10:05:59-05:00",
            "last_updated": "2019-07-23T10:10:47-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /catalogues/{id}

A single catalogue by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/catalogues/536?limit=2
Example output:

{
    "data": {
        "id": 536,
        "api_model": "catalogues",
        "api_link": "https://aggregator-data.artic.edu/api/v1/catalogues/536",
        "title": "Chamberlain",
        "last_updated_source": "2019-10-15T09:35:50-05:00",
        "last_updated": "2019-10-15T09:36:17-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Category Terms

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /category-terms

A list of all category-terms sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/category-terms?limit=2
Example output:

{
    "pagination": {
        "total": 8800,
        "limit": 2,
        "offset": 0,
        "total_pages": 4400,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/category-terms?page=2&limit=2"
    },
    "data": [
        {
            "id": "TM-14095",
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14095",
            "title": "Frames",
            "subtype": null,
            "parent_id": null,
            ...
        },
        {
            "id": "TM-14094",
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14094",
            "title": "Borrower has approved costs per RLE",
            "subtype": null,
            "parent_id": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /category-terms/search

Search category-terms data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/category-terms/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 8800,
        "limit": 10,
        "offset": 0,
        "total_pages": 880,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-10541",
            "id": "TM-10541",
            "title": "silver gilt strips",
            "timestamp": "2020-02-21T04:13:36-06:00"
        },
        {
            "_score": 1,
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-10542",
            "id": "TM-10542",
            "title": "compound weaving",
            "timestamp": "2020-02-21T04:13:36-06:00"
        },
        {
            "_score": 1,
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-10543",
            "id": "TM-10543",
            "title": "gold gilt strips",
            "timestamp": "2020-02-21T04:13:36-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /category-terms/{id}

A single category-term by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/category-terms/TM-14095?limit=2
Example output:

{
    "data": {
        "id": "TM-14095",
        "api_model": "category-terms",
        "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14095",
        "title": "Frames",
        "subtype": null,
        "parent_id": null,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Category Terms

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /category-terms

A list of all category-terms sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/category-terms?limit=2
Example output:

{
    "pagination": {
        "total": 8800,
        "limit": 2,
        "offset": 0,
        "total_pages": 4400,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/category-terms?page=2&limit=2"
    },
    "data": [
        {
            "id": "TM-14095",
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14095",
            "title": "Frames",
            "subtype": null,
            "parent_id": null,
            ...
        },
        {
            "id": "TM-14094",
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14094",
            "title": "Borrower has approved costs per RLE",
            "subtype": null,
            "parent_id": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /category-terms/{id}

A single category-term by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/category-terms/TM-14095?limit=2
Example output:

{
    "data": {
        "id": "TM-14095",
        "api_model": "category-terms",
        "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14095",
        "title": "Frames",
        "subtype": null,
        "parent_id": null,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Category Terms

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /category-terms

A list of all category-terms sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/category-terms?limit=2
Example output:

{
    "pagination": {
        "total": 8800,
        "limit": 2,
        "offset": 0,
        "total_pages": 4400,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/category-terms?page=2&limit=2"
    },
    "data": [
        {
            "id": "TM-14095",
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14095",
            "title": "Frames",
            "subtype": null,
            "parent_id": null,
            ...
        },
        {
            "id": "TM-14094",
            "api_model": "category-terms",
            "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/TM-14094",
            "title": "Borrower has approved costs per RLE",
            "subtype": null,
            "parent_id": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /category-terms/{id}

A single category-term by the given identifier. {id} is the identifier from our collections management system.

Example request: https://aggregator-data.artic.edu/api/v1/category-terms/PC-834?limit=2
Example output:

{
    "data": {
        "id": "PC-834",
        "api_model": "category-terms",
        "api_link": "https://aggregator-data.artic.edu/api/v1/category-terms/PC-834",
        "title": "Halloween",
        "subtype": "theme",
        "parent_id": null,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Assets

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /assets

A list of all assets sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/assets?limit=2
Example output:

{
    "pagination": {
        "total": 139910,
        "limit": 2,
        "offset": 0,
        "total_pages": 69955,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/assets?page=2&limit=2"
    },
    "data": [
        {
            "id": "9c6f6404-2d2b-8b9b-361b-d0e6a51a0e58",
            "lake_guid": "9c6f6404-2d2b-8b9b-361b-d0e6a51a0e58",
            "api_model": "assets",
            "api_link": "https://aggregator-data.artic.edu/api/v1/assets/9c6f6404-2d2b-8b9b-361b-d0e6a51a0e58",
            "title": "45748",
            "type": "image",
            ...
        },
        {
            "id": "8312e386-307d-630b-0335-3e924a708127",
            "lake_guid": "8312e386-307d-630b-0335-3e924a708127",
            "api_model": "assets",
            "api_link": "https://aggregator-data.artic.edu/api/v1/assets/8312e386-307d-630b-0335-3e924a708127",
            "title": "IM046236",
            "type": "image",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /assets/{id}

A single asset by the given identifier. {id} is the identifier from our collections management system.

Images

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /images

A list of all images sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/images?limit=2
Example output:

{
    "pagination": {
        "total": 136747,
        "limit": 2,
        "offset": 0,
        "total_pages": 68374,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/images?page=2&limit=2"
    },
    "data": [
        {
            "id": "9c6f6404-2d2b-8b9b-361b-d0e6a51a0e58",
            "lake_guid": "9c6f6404-2d2b-8b9b-361b-d0e6a51a0e58",
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/9c6f6404-2d2b-8b9b-361b-d0e6a51a0e58",
            "title": "45748",
            "type": "image",
            ...
        },
        {
            "id": "8312e386-307d-630b-0335-3e924a708127",
            "lake_guid": "8312e386-307d-630b-0335-3e924a708127",
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/8312e386-307d-630b-0335-3e924a708127",
            "title": "IM046236",
            "type": "image",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /images/search

Search images data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/images/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 136748,
        "limit": 10,
        "offset": 0,
        "total_pages": 13675,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/24ef3df1-e3ae-8d26-6e09-ac79eef4b1c3",
            "id": "24ef3df1-e3ae-8d26-6e09-ac79eef4b1c3",
            "title": "E38509",
            "timestamp": "2020-02-07T04:45:44-06:00"
        },
        {
            "_score": 1,
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/069baa86-b2ae-8623-4e87-2c9f20f55733",
            "id": "069baa86-b2ae-8623-4e87-2c9f20f55733",
            "title": "IM000500",
            "timestamp": "2020-02-21T04:18:45-06:00"
        },
        {
            "_score": 1,
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/069c0267-3043-2ab9-ef7a-a1a8a115b254",
            "id": "069c0267-3043-2ab9-ef7a-a1a8a115b254",
            "title": "PD_101716_12",
            "timestamp": "2020-02-21T04:18:45-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /images/{id}

A single image by the given identifier. {id} is the identifier from our collections management system.

Videos

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /videos

A list of all videos sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/videos?limit=2
Example output:

{
    "pagination": {
        "total": 5,
        "limit": 2,
        "offset": 0,
        "total_pages": 3,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/videos?page=2&limit=2"
    },
    "data": [
        {
            "id": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "lake_guid": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "api_model": "videos",
            "api_link": "https://aggregator-data.artic.edu/api/v1/videos/c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "title": "Under Cover: The Science of Van Gogh's Bedroom",
            "type": "video",
            ...
        },
        {
            "id": "eb06edce-6f2e-727c-0cee-a32cef589911",
            "lake_guid": "eb06edce-6f2e-727c-0cee-a32cef589911",
            "api_model": "videos",
            "api_link": "https://aggregator-data.artic.edu/api/v1/videos/eb06edce-6f2e-727c-0cee-a32cef589911",
            "title": "A Thousand and One Swabs: The Transformation of \"Paris Street; Rainy Day\"",
            "type": "video",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /videos/search

Search videos data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/videos/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 5,
        "limit": 10,
        "offset": 0,
        "total_pages": 1,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "videos",
            "api_link": "https://aggregator-data.artic.edu/api/v1/videos/1ee4a231-0dad-2638-24fd-dfa2138eb142",
            "id": "1ee4a231-0dad-2638-24fd-dfa2138eb142",
            "title": "Digital Simulation: Original appearance of <em>For to Be a Farmer's Boy</em>",
            "timestamp": "2020-02-21T07:20:08-06:00"
        },
        {
            "_score": 1,
            "api_model": "videos",
            "api_link": "https://aggregator-data.artic.edu/api/v1/videos/c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "id": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "title": "Under Cover: The Science of Van Gogh's Bedroom",
            "timestamp": "2020-02-21T07:20:08-06:00"
        },
        {
            "_score": 1,
            "api_model": "videos",
            "api_link": "https://aggregator-data.artic.edu/api/v1/videos/c5700df1-473c-c1cd-ab1b-79b20a32fc27",
            "id": "c5700df1-473c-c1cd-ab1b-79b20a32fc27",
            "title": "Online Game: Winslow Homer's <em>The Water Fan</em>",
            "timestamp": "2020-02-21T07:20:08-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /videos/{id}

A single video by the given identifier. {id} is the identifier from our collections management system.

Sounds

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /sounds

A list of all sounds sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/sounds?limit=2
Example output:

{
    "pagination": {
        "total": 1090,
        "limit": 2,
        "offset": 0,
        "total_pages": 545,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/sounds?page=2&limit=2"
    },
    "data": [
        {
            "id": "8f1ce112-189f-2b4e-2926-8d9a69b6a25e",
            "lake_guid": "8f1ce112-189f-2b4e-2926-8d9a69b6a25e",
            "api_model": "sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sounds/8f1ce112-189f-2b4e-2926-8d9a69b6a25e",
            "title": "Audio stop 796.mp3",
            "type": "sound",
            ...
        },
        {
            "id": "3c8e9309-d482-7a61-ba16-9d4966e87a27",
            "lake_guid": "3c8e9309-d482-7a61-ba16-9d4966e87a27",
            "api_model": "sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sounds/3c8e9309-d482-7a61-ba16-9d4966e87a27",
            "title": "Audio stop 843.mp3",
            "type": "sound",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /sounds/search

Search sounds data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/sounds/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 1090,
        "limit": 10,
        "offset": 0,
        "total_pages": 109,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sounds/31ee173d-cd35-88ef-9362-61722a5e10bf",
            "id": "31ee173d-cd35-88ef-9362-61722a5e10bf",
            "title": "Audio stop 442.wav",
            "timestamp": "2020-02-21T07:20:16-06:00"
        },
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sounds/3228923e-471f-7f34-4bdc-748b3567a615",
            "id": "3228923e-471f-7f34-4bdc-748b3567a615",
            "title": "Related Story: HEAR More about Matta\u2019s Process",
            "timestamp": "2020-02-21T07:20:16-06:00"
        },
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sounds/32567376-07e6-d70f-fbbe-6afb900d5bdf",
            "id": "32567376-07e6-d70f-fbbe-6afb900d5bdf",
            "title": "Audio Lecture: Technical Study of Saint John in the Wilderness",
            "timestamp": "2020-02-21T07:20:16-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /sounds/{id}

A single sound by the given identifier. {id} is the identifier from our collections management system.

Texts

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

GET /texts

A list of all texts sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/texts?limit=2
Example output:

{
    "pagination": {
        "total": 2068,
        "limit": 2,
        "offset": 0,
        "total_pages": 1034,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/texts?page=2&limit=2"
    },
    "data": [
        {
            "id": "d2e1d595-cbef-4e95-907a-d35b1f76ef59",
            "lake_guid": "d2e1d595-cbef-4e95-907a-d35b1f76ef59",
            "api_model": "texts",
            "api_link": "https://aggregator-data.artic.edu/api/v1/texts/d2e1d595-cbef-4e95-907a-d35b1f76ef59",
            "title": "Monet's City, Gare Saint-Lazare painting",
            "type": "text",
            ...
        },
        {
            "id": "d18f8b6a-ee30-b7a8-3d3b-b7fcfab1a1e7",
            "lake_guid": "d18f8b6a-ee30-b7a8-3d3b-b7fcfab1a1e7",
            "api_model": "texts",
            "api_link": "https://aggregator-data.artic.edu/api/v1/texts/d18f8b6a-ee30-b7a8-3d3b-b7fcfab1a1e7",
            "title": "Audio Transcript 827.txt",
            "type": "text",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /texts/search

Search texts data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/texts/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 2068,
        "limit": 10,
        "offset": 0,
        "total_pages": 207,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://aggregator-data.artic.edu/api/v1/texts/5f5c70df-5eb9-f8da-0b58-573f028ce1cc",
            "id": "5f5c70df-5eb9-f8da-0b58-573f028ce1cc",
            "title": "AIC1929Murals_comb.pdf",
            "timestamp": "2020-02-21T07:20:55-06:00"
        },
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://aggregator-data.artic.edu/api/v1/texts/5f8ebe21-8468-93c2-a75b-21bed86ef89d",
            "id": "5f8ebe21-8468-93c2-a75b-21bed86ef89d",
            "title": "Audio transcript 762.txt",
            "timestamp": "2020-02-21T07:20:55-06:00"
        },
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://aggregator-data.artic.edu/api/v1/texts/5fa304e1-77e4-6adb-953a-b3f7bc5457eb",
            "id": "5fa304e1-77e4-6adb-953a-b3f7bc5457eb",
            "title": "AIC1971MiroSculpture_comb.pdf",
            "timestamp": "2020-02-21T07:20:55-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /texts/{id}

A single text by the given identifier. {id} is the identifier from our collections management system.

Shop

Shop Categories

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /shop-categories

A list of all shop-categories sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • children

Example request: https://aggregator-data.artic.edu/api/v1/shop-categories?limit=2
Example output:

{
    "pagination": {
        "total": 87,
        "limit": 2,
        "offset": 0,
        "total_pages": 44,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/shop-categories?page=2&limit=2"
    },
    "data": [
        {
            "id": 56,
            "api_model": "shop-categories",
            "api_link": "https://aggregator-data.artic.edu/api/v1/shop-categories/56",
            "title": "Totes",
            "web_url": "https://shop.artic.edu/browse.aspx?catID=56",
            "parent_id": 3,
            ...
        },
        {
            "id": 53,
            "api_model": "shop-categories",
            "api_link": "https://aggregator-data.artic.edu/api/v1/shop-categories/53",
            "title": "Religious",
            "web_url": "https://shop.artic.edu/browse.aspx?catID=53",
            "parent_id": 6,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /shop-categories/search

Search shop-categories data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/shop-categories/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 87,
        "limit": 10,
        "offset": 0,
        "total_pages": 9,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "shop-categories",
            "api_link": "https://aggregator-data.artic.edu/api/v1/shop-categories/2",
            "id": 2,
            "title": "Books & Prints",
            "timestamp": "2020-02-21T07:21:03-06:00"
        },
        {
            "_score": 1,
            "api_model": "shop-categories",
            "api_link": "https://aggregator-data.artic.edu/api/v1/shop-categories/3",
            "id": 3,
            "title": "Fashion & Accessories",
            "timestamp": "2020-02-21T07:21:03-06:00"
        },
        {
            "_score": 1,
            "api_model": "shop-categories",
            "api_link": "https://aggregator-data.artic.edu/api/v1/shop-categories/4",
            "id": 4,
            "title": "Decor",
            "timestamp": "2020-02-21T07:21:03-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /shop-categories/{id}

A single shop-category by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/shop-categories/56?limit=2
Example output:

{
    "data": {
        "id": 56,
        "api_model": "shop-categories",
        "api_link": "https://aggregator-data.artic.edu/api/v1/shop-categories/56",
        "title": "Totes",
        "web_url": "https://shop.artic.edu/browse.aspx?catID=56",
        "parent_id": 3,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Products

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /products

A list of all products sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/products?limit=2
Example output:

{
    "pagination": {
        "total": 6780,
        "limit": 2,
        "offset": 0,
        "total_pages": 3390,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/products?page=2&limit=2"
    },
    "data": [
        {
            "id": 6970,
            "api_model": "products",
            "api_link": "https://aggregator-data.artic.edu/api/v1/products/6970",
            "title": "FPT RAFFAEL WHITE LILY",
            "title_sort": null,
            "is_active": false,
            ...
        },
        {
            "id": 6969,
            "api_model": "products",
            "api_link": "https://aggregator-data.artic.edu/api/v1/products/6969",
            "title": "FPT KOOP SUMMER SALES FRAME",
            "title_sort": null,
            "is_active": false,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /products/search

Search products data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/products/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 6780,
        "limit": 10,
        "offset": 0,
        "total_pages": 678,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "products",
            "api_link": "https://aggregator-data.artic.edu/api/v1/products/339",
            "id": 339,
            "title": "Monet Water Lilies Nightlight",
            "timestamp": "2020-02-21T07:21:04-06:00"
        },
        {
            "_score": 1,
            "api_model": "products",
            "api_link": "https://aggregator-data.artic.edu/api/v1/products/340",
            "id": 340,
            "title": "Brown Mission Nightlight",
            "timestamp": "2020-02-21T07:21:04-06:00"
        },
        {
            "_score": 1,
            "api_model": "products",
            "api_link": "https://aggregator-data.artic.edu/api/v1/products/344",
            "id": 344,
            "title": "Mackintosh-inspired Table Lamp",
            "timestamp": "2020-02-21T07:21:04-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /products/{id}

A single product by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/products/4272?limit=2
Example output:

{
    "data": {
        "id": 4272,
        "api_model": "products",
        "api_link": "https://aggregator-data.artic.edu/api/v1/products/4272",
        "title": "The Age of French Impressionism: Masterpieces from the Art Institute of Chicago",
        "title_sort": null,
        "is_active": true,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Mobile

Tours

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /tours

A list of all tours sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • tour_stops

Example request: https://aggregator-data.artic.edu/api/v1/tours?limit=2
Example output:

{
    "pagination": {
        "total": 15,
        "limit": 2,
        "offset": 0,
        "total_pages": 8,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/tours?page=2&limit=2"
    },
    "data": [
        {
            "id": 3246,
            "api_model": "tours",
            "api_link": "https://aggregator-data.artic.edu/api/v1/tours/3246",
            "title": "Verbal Description tour: The Essentials",
            "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/IM016907_020.jpg",
            "description": "<p>Designed for people with impaired vision: Discover our Essentials Tour.</p>\n",
            ...
        },
        {
            "id": 1000,
            "api_model": "tours",
            "api_link": "https://aggregator-data.artic.edu/api/v1/tours/1000",
            "title": "Magic of the Miniature",
            "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/E17048_reduced.jpg",
            "description": "<p>Travel back in time through the magic of the Thorne Rooms.</p>\n",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /tours/search

Search tours data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/tours/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 17,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "tours",
            "api_link": "https://aggregator-data-dev.artic.edu/api/v1/tours/4636",
            "id": 4636,
            "title": "MD Test Tour",
            "timestamp": "2019-12-05T11:00:47-06:00"
        },
        {
            "_score": 1,
            "api_model": "tours",
            "api_link": "https://aggregator-data.artic.edu/api/v1/tours/4520",
            "id": 4520,
            "title": "Manet and Modern Beauty",
            "timestamp": "2019-09-13T06:31:28-05:00"
        },
        {
            "_score": 1,
            "api_model": "tours",
            "api_link": "https://aggregator-data.artic.edu/api/v1/tours/1000",
            "id": 1000,
            "title": "Magic of the Miniature",
            "timestamp": "2020-02-21T07:21:41-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /tours/{id}

A single tour by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/tours/3246?limit=2
Example output:

{
    "data": {
        "id": 3246,
        "api_model": "tours",
        "api_link": "https://aggregator-data.artic.edu/api/v1/tours/3246",
        "title": "Verbal Description tour: The Essentials",
        "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/IM016907_020.jpg",
        "description": "<p>Designed for people with impaired vision: Discover our Essentials Tour.</p>\n",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Mobile Sounds

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /mobile-sounds

A list of all mobile-sounds sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/mobile-sounds?limit=2
Example output:

{
    "pagination": {
        "total": 756,
        "limit": 2,
        "offset": 0,
        "total_pages": 378,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/mobile-sounds?page=2&limit=2"
    },
    "data": [
        {
            "id": 4631,
            "api_model": "mobile-sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/mobile-sounds/4631",
            "title": "Japanese Prints Introduction",
            "web_url": "https://www.artic.edu/mobile/audio/G107%20Japanese%20Prints%20Intro.mp3",
            "transcript": null,
            ...
        },
        {
            "id": 4606,
            "api_model": "mobile-sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/mobile-sounds/4606",
            "title": "Nine Jackies",
            "web_url": "https://www.artic.edu/mobile/audio/247124_AD_Nine%20Jackies.mp3",
            "transcript": "<p>Narrator: This painting, entitled Nine Jackies, was made by Andy Warhol in 1964. It examines the public persona of Jacqueline Kennedy before and after the assassination of her husband, President John F. Kennedy. To make it, Warhol pulled images of her directly from the newspaper, carefully cropping them to eliminate everything but Jackie\u2019s image.The painting is hung vertically, measuring five feet tall by four feet wide. It is composed of nine individual screenprints on canvas, organized in three rows of three, each twenty inches tall by sixteen inches wide. Each of the rows of screenprints is a single image repeated three times, so while there are nine rectangles, there are only three different images.</p>\n<p>The top row reveals a smiling, happy Jackie, cropped so that only her head and shoulders are visible. The image itself is made of black ink, and the background behind the images in this row is a bright, warm blue. The black ink is a bit blotchy, suggesting newsprint. Jackie looks straight into the camera, smiling broadly. She wears a small pillbox hat that tilts jauntily to the left, while her hair is bouncy and loose. Little can be seen of the background; there is a suggestion of someone standing next to her, possibly the president. This photograph was taken shortly before the assassination.</p>\n<p>The second row of images are made up the same sketchy black ink, but the background color is a dull, somber gray. The First Lady appears in front of a man in military uniform; both gaze stoically to the right. This image comes from the president\u2019s funeral; the figures are watching as his coffin was carried into the Capitol. The image reveals Jackie as a public figure very much controlling her emotions throughout this highly publicized ceremony.</p>\n<p>The final row of images zooms in even closer to Jackie\u2019s face, photographed at Lyndon B. Johnson\u2019s swearing-in ceremony, shortly after Kennedy was pronounced dead. Once again, the image is printed in black ink, but the background color changes from rectangle to rectangle, from teal to blue and back again. Here her face appears in profile, her perfectly placed bangs obscuring her eyes. However, her hunched posture and slack mouth clearly indicate a moment of deep sadness. By juxtaposing different subtle moods Jackie displayed in the media, Warhol proposes that the viewer understand the national tragedy through the lens of her public persona.</p>\n",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /mobile-sounds/search

Search mobile-sounds data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/mobile-sounds/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 758,
        "limit": 10,
        "offset": 0,
        "total_pages": 76,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "mobile-sounds",
            "api_link": "https://aggregator-data-dev.artic.edu/api/v1/mobile-sounds/4528",
            "id": 4528,
            "title": "Statue of a Young Satyr Wearing a Theater Mask of Silenos",
            "timestamp": "2019-12-05T11:00:45-06:00"
        },
        {
            "_score": 1,
            "api_model": "mobile-sounds",
            "api_link": "https://aggregator-data-dev.artic.edu/api/v1/mobile-sounds/4637",
            "id": 4637,
            "title": "Intro",
            "timestamp": "2019-12-05T11:00:46-06:00"
        },
        {
            "_score": 1,
            "api_model": "mobile-sounds",
            "api_link": "https://aggregator-data.artic.edu/api/v1/mobile-sounds/226",
            "id": 226,
            "title": "Intro",
            "timestamp": "2020-02-21T07:21:48-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /mobile-sounds/{id}

A single mobile-sound by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/mobile-sounds/4631?limit=2
Example output:

{
    "data": {
        "id": 4631,
        "api_model": "mobile-sounds",
        "api_link": "https://aggregator-data.artic.edu/api/v1/mobile-sounds/4631",
        "title": "Japanese Prints Introduction",
        "web_url": "https://www.artic.edu/mobile/audio/G107%20Japanese%20Prints%20Intro.mp3",
        "transcript": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Digital Scholarly Catalogs

Publications

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /publications

A list of all publications sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/publications?limit=2
Example output:

{
    "pagination": {
        "total": 12,
        "limit": 2,
        "offset": 0,
        "total_pages": 6,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/publications?page=2&limit=2"
    },
    "data": [
        {
            "id": 141096,
            "api_model": "publications",
            "api_link": "https://aggregator-data.artic.edu/api/v1/publications/141096",
            "title": "Gauguin Paintings, Sculpture, and Graphic Works at the Art Institute of Chicago",
            "web_url": "https://publications.artic.edu/gauguin/reader/gauguinart",
            "site": "gauguin",
            ...
        },
        {
            "id": 140019,
            "api_model": "publications",
            "api_link": "https://aggregator-data.artic.edu/api/v1/publications/140019",
            "title": "Manet Paintings and Works on Paper at the Art Institute of Chicago",
            "web_url": "https://publications.artic.edu/manet/reader/manetart",
            "site": "manet",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /publications/search

Search publications data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/publications/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 12,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "publications",
            "api_link": "https://aggregator-data.artic.edu/api/v1/publications/2",
            "id": 2,
            "title": "American Silver in the Art Institute of Chicago",
            "timestamp": "2020-02-21T07:21:57-06:00"
        },
        {
            "_score": 1,
            "api_model": "publications",
            "api_link": "https://aggregator-data.artic.edu/api/v1/publications/7",
            "id": 7,
            "title": "Pissarro Paintings and Works on Paper at the Art Institute of Chicago",
            "timestamp": "2020-02-21T07:21:57-06:00"
        },
        {
            "_score": 1,
            "api_model": "publications",
            "api_link": "https://aggregator-data.artic.edu/api/v1/publications/12",
            "id": 12,
            "title": "The Modern Series at the Art Institute of Chicago",
            "timestamp": "2020-02-21T07:21:57-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /publications/{id}

A single publication by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/publications/141096?limit=2
Example output:

{
    "data": {
        "id": 141096,
        "api_model": "publications",
        "api_link": "https://aggregator-data.artic.edu/api/v1/publications/141096",
        "title": "Gauguin Paintings, Sculpture, and Graphic Works at the Art Institute of Chicago",
        "web_url": "https://publications.artic.edu/gauguin/reader/gauguinart",
        "site": "gauguin",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Sections

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /sections

A list of all sections sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/sections?limit=2
Example output:

{
    "pagination": {
        "total": 1124,
        "limit": 2,
        "offset": 0,
        "total_pages": 562,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/sections?page=2&limit=2"
    },
    "data": [
        {
            "id": 128775,
            "api_model": "sections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sections/128775",
            "title": "Bibliography",
            "web_url": "https://publications.artic.edu/americansilver/reader/collection/section/504",
            "accession": null,
            ...
        },
        {
            "id": 108342,
            "api_model": "sections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sections/108342",
            "title": "Select Silver Objects in the Collection of the Art Institute of Chicago",
            "web_url": "https://publications.artic.edu/americansilver/reader/collection/section/462",
            "accession": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /sections/search

Search sections data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/sections/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 1124,
        "limit": 10,
        "offset": 0,
        "total_pages": 113,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sections/2997095",
            "id": 2997095,
            "title": "Cat. 156 \u00a0Mummy Portrait of a Man Wearing a Laurel Wreath, early to mid-2nd century A.D.",
            "timestamp": "2020-02-18T07:35:31-06:00"
        },
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sections/2999544",
            "id": 2999544,
            "title": "Architectural Reliefs",
            "timestamp": "2020-02-18T07:35:31-06:00"
        },
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sections/3001994",
            "id": 3001994,
            "title": "Works in Depth",
            "timestamp": "2020-02-18T07:35:31-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /sections/{id}

A single section by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/sections/128775?limit=2
Example output:

{
    "data": {
        "id": 128775,
        "api_model": "sections",
        "api_link": "https://aggregator-data.artic.edu/api/v1/sections/128775",
        "title": "Bibliography",
        "web_url": "https://publications.artic.edu/americansilver/reader/collection/section/504",
        "accession": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Static Archive

Sites

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /sites

A list of all sites sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • artworks

Example request: https://aggregator-data.artic.edu/api/v1/sites?limit=2
Example output:

{
    "pagination": {
        "total": 96,
        "limit": 2,
        "offset": 0,
        "total_pages": 48,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/sites?page=2&limit=2"
    },
    "data": [
        {
            "id": 96,
            "api_model": "sites",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sites/96",
            "title": "Van Gogh's Bedrooms",
            "description": "Vincent van Gogh\u2019s bedroom in Arles is arguably the most famous chambre in the history of art. It also held special significance for the artist, who created three distinct paintings of this intimate space from 1888 to 1889. This exhibition\u2014presented only at the Art Institute of Chicago\u2014brings together all three versions of The Bedroom for the first time in North America, offering a pioneering and in-depth study of their making and meaning to Van Gogh in his relentless quest for home.",
            "web_url": "http://archive.artic.edu/van-gogh-bedrooms/",
            ...
        },
        {
            "id": 95,
            "api_model": "sites",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sites/95",
            "title": "Game of Thornes: A Maze of Miniature Proportions",
            "description": "This fantasy world comes in delightfully pint-sized pieces\u2014the Thorne Miniature Rooms. Your mission: navigate you escape from this mystifying realm of riddled rooms.",
            "web_url": "http://archive.artic.edu/thorne-game/",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /sites/search

Search sites data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/sites/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 96,
        "limit": 10,
        "offset": 0,
        "total_pages": 10,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "sites",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sites/1",
            "id": 1,
            "title": "Chicago Architecture: Ten Visions",
            "timestamp": "2020-02-18T07:36:07-06:00"
        },
        {
            "_score": 1,
            "api_model": "sites",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sites/2",
            "id": 2,
            "title": "American Perspectives: A yearlong celebration of American artistic vision",
            "timestamp": "2020-02-18T07:36:07-06:00"
        },
        {
            "_score": 1,
            "api_model": "sites",
            "api_link": "https://aggregator-data.artic.edu/api/v1/sites/3",
            "id": 3,
            "title": "Curious Corner",
            "timestamp": "2020-02-18T07:36:07-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /sites/{id}

A single site by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/sites/96?limit=2
Example output:

{
    "data": {
        "id": 96,
        "api_model": "sites",
        "api_link": "https://aggregator-data.artic.edu/api/v1/sites/96",
        "title": "Van Gogh's Bedrooms",
        "description": "Vincent van Gogh\u2019s bedroom in Arles is arguably the most famous chambre in the history of art. It also held special significance for the artist, who created three distinct paintings of this intimate space from 1888 to 1889. This exhibition\u2014presented only at the Art Institute of Chicago\u2014brings together all three versions of The Bedroom for the first time in North America, offering a pioneering and in-depth study of their making and meaning to Van Gogh in his relentless quest for home.",
        "web_url": "http://archive.artic.edu/van-gogh-bedrooms/",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Website

Closures

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /closures

A list of all closures sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/closures?limit=2
Example output:

{
    "pagination": {
        "total": 8,
        "limit": 2,
        "offset": 0,
        "total_pages": 4,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/closures?page=2&limit=2"
    },
    "data": [
        {
            "id": 9,
            "api_model": "closures",
            "api_link": "https://aggregator-data.artic.edu/api/v1/closures/9",
            "title": "Lorem ipsum.",
            "date_start": "2020-11-26T00:00:00-06:00",
            "date_end": "2020-11-26T00:00:00-06:00",
            ...
        },
        {
            "id": 5,
            "api_model": "closures",
            "api_link": "https://aggregator-data.artic.edu/api/v1/closures/5",
            "title": "Lorem ipsum.",
            "date_start": "2020-01-01T00:00:00-06:00",
            "date_end": "2020-01-01T00:00:00-06:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /closures/search

Search closures data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/closures/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 8,
        "limit": 10,
        "offset": 0,
        "total_pages": 1,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://aggregator-data.artic.edu/api/v1/closures/1",
            "id": 1,
            "title": "Lorem ipsum.",
            "timestamp": "2020-02-18T07:36:10-06:00"
        },
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://aggregator-data.artic.edu/api/v1/closures/2",
            "id": 2,
            "title": "Lorem ipsum.",
            "timestamp": "2020-02-18T07:36:10-06:00"
        },
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://aggregator-data.artic.edu/api/v1/closures/3",
            "id": 3,
            "title": "Lorem ipsum.",
            "timestamp": "2020-02-18T07:36:10-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /closures/{id}

A single closure by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/closures/9?limit=2
Example output:

{
    "data": {
        "id": 9,
        "api_model": "closures",
        "api_link": "https://aggregator-data.artic.edu/api/v1/closures/9",
        "title": "Lorem ipsum.",
        "date_start": "2020-11-26T00:00:00-06:00",
        "date_end": "2020-11-26T00:00:00-06:00",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Web Exhibitions

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /web-exhibitions

A list of all web-exhibitions sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/web-exhibitions?limit=2
Example output:

{
    "pagination": {
        "total": 672,
        "limit": 2,
        "offset": 0,
        "total_pages": 336,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/web-exhibitions?page=2&limit=2"
    },
    "data": [
        {
            "id": 623,
            "api_model": "web-exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-exhibitions/623",
            "title": "A New View of African Art",
            "exhibition_id": 9208,
            "is_featured": true,
            ...
        },
        {
            "id": 683,
            "api_model": "web-exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-exhibitions/683",
            "title": "K\u00e4the Kollwitz and the Art of Resistance",
            "exhibition_id": 9254,
            "is_featured": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /web-exhibitions/search

Search web-exhibitions data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/web-exhibitions/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 673,
        "limit": 10,
        "offset": 0,
        "total_pages": 68,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "web-exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-exhibitions/2",
            "id": 2,
            "title": "Manet and Modern Beauty",
            "timestamp": "2020-02-18T07:36:10-06:00"
        },
        {
            "_score": 1,
            "api_model": "web-exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-exhibitions/6",
            "id": 6,
            "title": "Past Forward: Architecture and Design at the Art Institute",
            "timestamp": "2020-02-18T07:36:10-06:00"
        },
        {
            "_score": 1,
            "api_model": "web-exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-exhibitions/7",
            "id": 7,
            "title": "Flesh: Ivan Albright at the Art Institute of Chicago",
            "timestamp": "2020-02-18T07:36:10-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /web-exhibitions/{id}

A single web-exhibition by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/web-exhibitions/623?limit=2
Example output:

{
    "data": {
        "id": 623,
        "api_model": "web-exhibitions",
        "api_link": "https://aggregator-data.artic.edu/api/v1/web-exhibitions/623",
        "title": "A New View of African Art",
        "exhibition_id": 9208,
        "is_featured": true,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Events

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /events

A list of all events sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • email_series_pivots
    • sponsor

Example request: https://aggregator-data.artic.edu/api/v1/events?limit=2
Example output:

{
    "pagination": {
        "total": 1947,
        "limit": 2,
        "offset": 0,
        "total_pages": 974,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/events?page=2&limit=2"
    },
    "data": [
        {
            "id": 4580,
            "api_model": "events",
            "api_link": "https://aggregator-data.artic.edu/api/v1/events/4580",
            "title": "Asian Art Council - Gallery Tour with Hongwei Li",
            "title_display": null,
            "published": false,
            ...
        },
        {
            "id": 4577,
            "api_model": "events",
            "api_link": "https://aggregator-data.artic.edu/api/v1/events/4577",
            "title": "Concert: Jamila Woods",
            "title_display": null,
            "published": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /events/search

Search events data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/events/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 1949,
        "limit": 10,
        "offset": 0,
        "total_pages": 195,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "events",
            "api_link": "https://aggregator-data.artic.edu/api/v1/events/4937",
            "id": 4937,
            "title": "Monet and Chicago",
            "timestamp": "2020-01-07T06:08:28-06:00"
        },
        {
            "_score": 1,
            "api_model": "events",
            "api_link": "https://aggregator-data.artic.edu/api/v1/events/4938",
            "id": 4938,
            "title": "Monet and Chicago",
            "timestamp": "2020-01-07T06:08:28-06:00"
        },
        {
            "_score": 1,
            "api_model": "events",
            "api_link": "https://aggregator-data.artic.edu/api/v1/events/3501",
            "id": 3501,
            "title": "Art+ History Mini-Conference",
            "timestamp": "2020-02-18T07:36:16-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /events/{id}

A single event by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/events/4577?limit=2
Example output:

{
    "data": {
        "id": 4577,
        "api_model": "events",
        "api_link": "https://aggregator-data.artic.edu/api/v1/events/4577",
        "title": "Concert: Jamila Woods",
        "title_display": null,
        "published": true,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Event Occurrences

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /event-occurrences

A list of all event-occurrences sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/event-occurrences?limit=2
Example output:

{
    "pagination": {
        "total": 471,
        "limit": 2,
        "offset": 0,
        "total_pages": 236,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/event-occurrences?page=2&limit=2"
    },
    "data": [
        {
            "id": 471,
            "api_model": "event-occurrences",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-occurrences/471",
            "title": "Exhibition Celebration: El Greco\u2014Ambition and Defiance",
            "event_id": 4712,
            "short_description": "Celebrate the opening of El Greco: Ambition and Defiance exhibition with a special lecture and cocktail reception.",
            ...
        },
        {
            "id": 461,
            "api_model": "event-occurrences",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-occurrences/461",
            "title": "Spotlight Talk: Water Drop by Mineo Mizuno",
            "event_id": 4762,
            "short_description": "30-minute gallery talk",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /event-occurrences/search

Search event-occurrences data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/event-occurrences/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 471,
        "limit": 10,
        "offset": 0,
        "total_pages": 48,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "event-occurrences",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-occurrences/1",
            "id": 1,
            "title": "Symposium: Signs and Wonders\u2014The Photographs of John Beasley Greene",
            "timestamp": "2020-02-18T07:36:25-06:00"
        },
        {
            "_score": 1,
            "api_model": "event-occurrences",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-occurrences/2",
            "id": 2,
            "title": "Special Event: Lunar New Year Celebration",
            "timestamp": "2020-02-18T07:36:25-06:00"
        },
        {
            "_score": 1,
            "api_model": "event-occurrences",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-occurrences/3",
            "id": 3,
            "title": "Gallery Talk: Modern Wing Highlights",
            "timestamp": "2020-02-18T07:36:25-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /event-occurrences/{id}

A single event-occurrence by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/event-occurrences/471?limit=2
Example output:

{
    "data": {
        "id": 471,
        "api_model": "event-occurrences",
        "api_link": "https://aggregator-data.artic.edu/api/v1/event-occurrences/471",
        "title": "Exhibition Celebration: El Greco\u2014Ambition and Defiance",
        "event_id": 4712,
        "short_description": "Celebrate the opening of El Greco: Ambition and Defiance exhibition with a special lecture and cocktail reception.",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Event Programs

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /event-programs

A list of all event-programs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/event-programs?limit=2
Example output:

{
    "pagination": {
        "total": 57,
        "limit": 2,
        "offset": 0,
        "total_pages": 29,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/event-programs?page=2&limit=2"
    },
    "data": [
        {
            "id": 60,
            "api_model": "event-programs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-programs/60",
            "title": "Special Topics Workshop",
            "is_affiliate_group": false,
            "is_event_host": false,
            ...
        },
        {
            "id": 26,
            "api_model": "event-programs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-programs/26",
            "title": "Woman\u2019s Board",
            "is_affiliate_group": false,
            "is_event_host": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /event-programs/search

Search event-programs data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/event-programs/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 57,
        "limit": 10,
        "offset": 0,
        "total_pages": 6,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "event-programs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-programs/1",
            "id": 1,
            "title": "Artist\u2019s Studio",
            "timestamp": "2020-02-18T07:36:26-06:00"
        },
        {
            "_score": 1,
            "api_model": "event-programs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-programs/2",
            "id": 2,
            "title": "Family Festivals",
            "timestamp": "2020-02-18T07:36:26-06:00"
        },
        {
            "_score": 1,
            "api_model": "event-programs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/event-programs/3",
            "id": 3,
            "title": "Picture This",
            "timestamp": "2020-02-18T07:36:26-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /event-programs/{id}

A single event-program by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/event-programs/60?limit=2
Example output:

{
    "data": {
        "id": 60,
        "api_model": "event-programs",
        "api_link": "https://aggregator-data.artic.edu/api/v1/event-programs/60",
        "title": "Special Topics Workshop",
        "is_affiliate_group": false,
        "is_event_host": false,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Articles

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /articles

A list of all articles sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/articles?limit=2
Example output:

{
    "pagination": {
        "total": 233,
        "limit": 2,
        "offset": 0,
        "total_pages": 117,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/articles?page=2&limit=2"
    },
    "data": [
        {
            "id": 801,
            "api_model": "articles",
            "api_link": "https://aggregator-data.artic.edu/api/v1/articles/801",
            "title": "the-mystery-and-allure-of-john-beasley-greene",
            "is_published": false,
            "date": "2020-02-17T00:00:00-06:00",
            ...
        },
        {
            "id": 799,
            "api_model": "articles",
            "api_link": "https://aggregator-data.artic.edu/api/v1/articles/799",
            "title": "buddha-shakyamuni-a-curators-insights",
            "is_published": true,
            "date": "2020-02-20T00:00:00-06:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /articles/search

Search articles data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/articles/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 233,
        "limit": 10,
        "offset": 0,
        "total_pages": 24,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "articles",
            "api_link": "https://aggregator-data.artic.edu/api/v1/articles/14",
            "id": 14,
            "title": "secrets-of-the-modern-wing",
            "timestamp": "2020-02-18T07:36:26-06:00"
        },
        {
            "_score": 1,
            "api_model": "articles",
            "api_link": "https://aggregator-data.artic.edu/api/v1/articles/18",
            "id": 18,
            "title": "your-move",
            "timestamp": "2020-02-18T07:36:26-06:00"
        },
        {
            "_score": 1,
            "api_model": "articles",
            "api_link": "https://aggregator-data.artic.edu/api/v1/articles/26",
            "id": 26,
            "title": "secrets-of-the-modern-wing-take-two",
            "timestamp": "2020-02-18T07:36:26-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /articles/{id}

A single article by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/articles/799?limit=2
Example output:

{
    "data": {
        "id": 799,
        "api_model": "articles",
        "api_link": "https://aggregator-data.artic.edu/api/v1/articles/799",
        "title": "buddha-shakyamuni-a-curators-insights",
        "is_published": true,
        "date": "2020-02-20T00:00:00-06:00",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Selections

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /selections

A list of all selections sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/selections?limit=2
Example output:

{
    "pagination": {
        "total": 11,
        "limit": 2,
        "offset": 0,
        "total_pages": 6,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/selections?page=2&limit=2"
    },
    "data": [
        {
            "id": 14,
            "api_model": "selections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/selections/14",
            "title": "el-greco-timeline",
            "published": false,
            "short_copy": "<p>El Greco today is revered as one of the greatest of the greats, but his life was full of ups and downs. Despite his relentless determination and vision, his success was often thwarted, his rewards often challenged.</p>",
            ...
        },
        {
            "id": 4,
            "api_model": "selections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/selections/4",
            "title": "new-on-view",
            "published": true,
            "short_copy": "The museum continually acquires new works by gift or by purchase that expand the stories that we tell in our galleries.",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /selections/search

Search selections data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/selections/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 11,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "selections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/selections/6",
            "id": 6,
            "title": "highlights-of-american-art",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "selections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/selections/8",
            "id": 8,
            "title": "holidays-at-the-art-institute-2019-20",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "selections",
            "api_link": "https://aggregator-data.artic.edu/api/v1/selections/9",
            "id": 9,
            "title": "modern-art",
            "timestamp": "2020-02-18T07:36:27-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /selections/{id}

A single selection by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/selections/4?limit=2
Example output:

{
    "data": {
        "id": 4,
        "api_model": "selections",
        "api_link": "https://aggregator-data.artic.edu/api/v1/selections/4",
        "title": "new-on-view",
        "published": true,
        "short_copy": "The museum continually acquires new works by gift or by purchase that expand the stories that we tell in our galleries.",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Web Artists

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /web-artists

A list of all web-artists sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/web-artists?limit=2
Example output:

{
    "pagination": {
        "total": 57,
        "limit": 2,
        "offset": 0,
        "total_pages": 29,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/web-artists?page=2&limit=2"
    },
    "data": [
        {
            "id": 61,
            "api_model": "web-artists",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-artists/61",
            "title": "Chicago Painter",
            "has_also_known_as": null,
            "intro_copy": "<p>While the identities of most artists from ancient Greece are unknown, many painters can be recognized by their distinctive artistic styles. Scholars often name these artists after the museums or institutions that own their works, or the place where their work was first identified.&nbsp;</p><p>This identification system was developed in the early 20th century by Sir John Beazley (1885\u20131970), a British art historian, classical archaeologist, and international authority on Greek art. Using his exceptional talent and sharp eye to focus on small stylistic details that distinguished the hand of one painter from that of another, Beazley was able to identify&nbsp; \u201csignatures\u201d or particular motifs used by specific artists. An artist might be recognized by something as subtle as the composition of eyes, noses, or hands. <br><br>The Chicago Painter was one such ancient Greek painter identified by Beazley, who first attributed Greek vases to the artist in his 1918 publication <em>Attic Red-Figured Vases in American Museums.</em> The painter was originally called the \"Painter of the Chicago Stamnos,\u201d which was shortened to the \"Chicago Painter.\" The name comes from a large stamnos (mixing jar) that was acquired by the Art Institute of Chicago in 1889 and was the first and finest example of this artist's work to be identified. While we do not know much about the artist, he was likely male and a capable draftsman, active in Athens in the middle of the 5th century BC. He was a follower or student of the Villa Giulia Painter (a painter named after a distinct vessel in the Villa Giulia Museum in Rome) and had a preference for depicting graceful and tender scenes where figures are focused on their individual tasks. The stamnos at the Art Institute, along with others that he decorated, depicts scenes related to the cult of the wine god Dionysos, highlighting his uncluttered, elegant signature style.</p>",
            ...
        },
        {
            "id": 60,
            "api_model": "web-artists",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-artists/60",
            "title": "Gerrit van Honthorst",
            "has_also_known_as": null,
            "intro_copy": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /web-artists/search

Search web-artists data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/web-artists/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 57,
        "limit": 10,
        "offset": 0,
        "total_pages": 6,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "web-artists",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-artists/1",
            "id": 1,
            "title": "Winslow Homer",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "web-artists",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-artists/2",
            "id": 2,
            "title": "Don A. DuBroff",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "web-artists",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-artists/3",
            "id": 3,
            "title": "Neue Galerie New York",
            "timestamp": "2020-02-18T07:36:27-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /web-artists/{id}

A single web-artist by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/web-artists/61?limit=2
Example output:

{
    "data": {
        "id": 61,
        "api_model": "web-artists",
        "api_link": "https://aggregator-data.artic.edu/api/v1/web-artists/61",
        "title": "Chicago Painter",
        "has_also_known_as": null,
        "intro_copy": "<p>While the identities of most artists from ancient Greece are unknown, many painters can be recognized by their distinctive artistic styles. Scholars often name these artists after the museums or institutions that own their works, or the place where their work was first identified.&nbsp;</p><p>This identification system was developed in the early 20th century by Sir John Beazley (1885\u20131970), a British art historian, classical archaeologist, and international authority on Greek art. Using his exceptional talent and sharp eye to focus on small stylistic details that distinguished the hand of one painter from that of another, Beazley was able to identify&nbsp; \u201csignatures\u201d or particular motifs used by specific artists. An artist might be recognized by something as subtle as the composition of eyes, noses, or hands. <br><br>The Chicago Painter was one such ancient Greek painter identified by Beazley, who first attributed Greek vases to the artist in his 1918 publication <em>Attic Red-Figured Vases in American Museums.</em> The painter was originally called the \"Painter of the Chicago Stamnos,\u201d which was shortened to the \"Chicago Painter.\" The name comes from a large stamnos (mixing jar) that was acquired by the Art Institute of Chicago in 1889 and was the first and finest example of this artist's work to be identified. While we do not know much about the artist, he was likely male and a capable draftsman, active in Athens in the middle of the 5th century BC. He was a follower or student of the Villa Giulia Painter (a painter named after a distinct vessel in the Villa Giulia Museum in Rome) and had a preference for depicting graceful and tender scenes where figures are focused on their individual tasks. The stamnos at the Art Institute, along with others that he decorated, depicts scenes related to the cult of the wine god Dionysos, highlighting his uncluttered, elegant signature style.</p>",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Static Pages

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /static-pages

A list of all static-pages sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/static-pages?limit=2
Example output:

{
    "pagination": {
        "total": 11,
        "limit": 2,
        "offset": 0,
        "total_pages": 6,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/static-pages?page=2&limit=2"
    },
    "data": [
        {
            "id": 1,
            "api_model": "static-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/static-pages/1",
            "title": "Visit",
            "web_url": "/visit",
            "is_published": true,
            ...
        },
        {
            "id": 2,
            "api_model": "static-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/static-pages/2",
            "title": "Events",
            "web_url": "/events",
            "is_published": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /static-pages/search

Search static-pages data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/static-pages/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 11,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "static-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/static-pages/1",
            "id": 1,
            "title": "Visit",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "static-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/static-pages/2",
            "id": 2,
            "title": "Events",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "static-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/static-pages/3",
            "id": 3,
            "title": "Exhibitions",
            "timestamp": "2020-02-18T07:36:27-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /static-pages/{id}

A single static-page by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/static-pages/1?limit=2
Example output:

{
    "data": {
        "id": 1,
        "api_model": "static-pages",
        "api_link": "https://aggregator-data.artic.edu/api/v1/static-pages/1",
        "title": "Visit",
        "web_url": "/visit",
        "is_published": true,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Generic Pages

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /generic-pages

A list of all generic-pages sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/generic-pages?limit=2
Example output:

{
    "pagination": {
        "total": 230,
        "limit": 2,
        "offset": 0,
        "total_pages": 115,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/generic-pages?page=2&limit=2"
    },
    "data": [
        {
            "id": 4,
            "api_model": "generic-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/generic-pages/4",
            "title": "Directions & Parking",
            "is_published": true,
            "type": null,
            ...
        },
        {
            "id": 248,
            "api_model": "generic-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/generic-pages/248",
            "title": "Visitors Who Are Blind or Have Low Vision",
            "is_published": true,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /generic-pages/search

Search generic-pages data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/generic-pages/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 230,
        "limit": 10,
        "offset": 0,
        "total_pages": 23,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "generic-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/generic-pages/1",
            "id": 1,
            "title": "Visit",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "generic-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/generic-pages/2",
            "id": 2,
            "title": "Free Admission Opportunities",
            "timestamp": "2020-02-18T07:36:27-06:00"
        },
        {
            "_score": 1,
            "api_model": "generic-pages",
            "api_link": "https://aggregator-data.artic.edu/api/v1/generic-pages/4",
            "id": 4,
            "title": "Directions & Parking",
            "timestamp": "2020-02-18T07:36:27-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /generic-pages/{id}

A single generic-page by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/generic-pages/4?limit=2
Example output:

{
    "data": {
        "id": 4,
        "api_model": "generic-pages",
        "api_link": "https://aggregator-data.artic.edu/api/v1/generic-pages/4",
        "title": "Directions & Parking",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Press Releases

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /press-releases

A list of all press-releases sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/press-releases?limit=2
Example output:

{
    "pagination": {
        "total": 268,
        "limit": 2,
        "offset": 0,
        "total_pages": 134,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/press-releases?page=2&limit=2"
    },
    "data": [
        {
            "id": 280,
            "api_model": "press-releases",
            "api_link": "https://aggregator-data.artic.edu/api/v1/press-releases/280",
            "title": "Pure Drawing: Seven Centuries of Art from the Gray Collection",
            "is_published": true,
            "type": null,
            ...
        },
        {
            "id": 279,
            "api_model": "press-releases",
            "api_link": "https://aggregator-data.artic.edu/api/v1/press-releases/279",
            "title": "Rubens, Rembrandt, and Drawing in the Golden Age",
            "is_published": true,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /press-releases/search

Search press-releases data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/press-releases/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 268,
        "limit": 10,
        "offset": 0,
        "total_pages": 27,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "press-releases",
            "api_link": "https://aggregator-data.artic.edu/api/v1/press-releases/1",
            "id": 1,
            "title": "Press Releases from 1939",
            "timestamp": "2020-02-18T07:36:28-06:00"
        },
        {
            "_score": 1,
            "api_model": "press-releases",
            "api_link": "https://aggregator-data.artic.edu/api/v1/press-releases/2",
            "id": 2,
            "title": "Press Releases from 1940",
            "timestamp": "2020-02-18T07:36:28-06:00"
        },
        {
            "_score": 1,
            "api_model": "press-releases",
            "api_link": "https://aggregator-data.artic.edu/api/v1/press-releases/3",
            "id": 3,
            "title": "Press Releases from 1941",
            "timestamp": "2020-02-18T07:36:28-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /press-releases/{id}

A single press-release by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/press-releases/280?limit=2
Example output:

{
    "data": {
        "id": 280,
        "api_model": "press-releases",
        "api_link": "https://aggregator-data.artic.edu/api/v1/press-releases/280",
        "title": "Pure Drawing: Seven Centuries of Art from the Gray Collection",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Educator Resources

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /educator-resources

A list of all educator-resources sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/educator-resources?limit=2
Example output:

{
    "pagination": {
        "total": 81,
        "limit": 2,
        "offset": 0,
        "total_pages": 41,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/educator-resources?page=2&limit=2"
    },
    "data": [
        {
            "id": 34,
            "api_model": "educator-resources",
            "api_link": "https://aggregator-data.artic.edu/api/v1/educator-resources/34",
            "title": "Educator Resource Packet: Shukongojin",
            "is_published": true,
            "type": null,
            ...
        },
        {
            "id": 19,
            "api_model": "educator-resources",
            "api_link": "https://aggregator-data.artic.edu/api/v1/educator-resources/19",
            "title": "Educator Resource Packet: Dancing Ganesha",
            "is_published": true,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /educator-resources/search

Search educator-resources data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/educator-resources/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 81,
        "limit": 10,
        "offset": 0,
        "total_pages": 9,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "educator-resources",
            "api_link": "https://aggregator-data.artic.edu/api/v1/educator-resources/2",
            "id": 2,
            "title": "Test Resource",
            "timestamp": "2020-02-18T07:36:29-06:00"
        },
        {
            "_score": 1,
            "api_model": "educator-resources",
            "api_link": "https://aggregator-data.artic.edu/api/v1/educator-resources/3",
            "id": 3,
            "title": "Activity: Arrival of the Normandy Train, Gare Saint-Lazare",
            "timestamp": "2020-02-18T07:36:29-06:00"
        },
        {
            "_score": 1,
            "api_model": "educator-resources",
            "api_link": "https://aggregator-data.artic.edu/api/v1/educator-resources/4",
            "id": 4,
            "title": "Activity: The Family Concert",
            "timestamp": "2020-02-18T07:36:29-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /educator-resources/{id}

A single educator-resource by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/educator-resources/34?limit=2
Example output:

{
    "data": {
        "id": 34,
        "api_model": "educator-resources",
        "api_link": "https://aggregator-data.artic.edu/api/v1/educator-resources/34",
        "title": "Educator Resource Packet: Shukongojin",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Digital Catalogs

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /digital-catalogs

A list of all digital-catalogs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/digital-catalogs?limit=2
Example output:

{
    "pagination": {
        "total": 14,
        "limit": 2,
        "offset": 0,
        "total_pages": 7,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/digital-catalogs?page=2&limit=2"
    },
    "data": [
        {
            "id": 31,
            "api_model": "digital-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/digital-catalogs/31",
            "title": "Matisse Paintings, Works on Paper, Sculpture, and Textiles at the Art Institute of Chicago",
            "is_published": true,
            "type": null,
            ...
        },
        {
            "id": 30,
            "api_model": "digital-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/digital-catalogs/30",
            "title": "Ivan Albright Paintings at the Art Institute of Chicago",
            "is_published": true,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /digital-catalogs/search

Search digital-catalogs data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/digital-catalogs/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 14,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "digital-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/digital-catalogs/2",
            "id": 2,
            "title": "American Silver",
            "timestamp": "2020-02-18T07:36:29-06:00"
        },
        {
            "_score": 1,
            "api_model": "digital-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/digital-catalogs/3",
            "id": 3,
            "title": "Modern Series: Go",
            "timestamp": "2020-02-18T07:36:29-06:00"
        },
        {
            "_score": 1,
            "api_model": "digital-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/digital-catalogs/4",
            "id": 4,
            "title": "Manet Paintings and Works on Paper at the Art Institute of Chicago",
            "timestamp": "2020-02-18T07:36:29-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /digital-catalogs/{id}

A single digital-catalog by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/digital-catalogs/31?limit=2
Example output:

{
    "data": {
        "id": 31,
        "api_model": "digital-catalogs",
        "api_link": "https://aggregator-data.artic.edu/api/v1/digital-catalogs/31",
        "title": "Matisse Paintings, Works on Paper, Sculpture, and Textiles at the Art Institute of Chicago",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Printed Catalogs

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

GET /printed-catalogs

A list of all printed-catalogs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

Available parameters:

  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource

Example request: https://aggregator-data.artic.edu/api/v1/printed-catalogs?limit=2
Example output:

{
    "pagination": {
        "total": 179,
        "limit": 2,
        "offset": 0,
        "total_pages": 90,
        "current_page": 1,
        "next_url": "https://aggregator-data.artic.edu/api/v1/printed-catalogs?page=2&limit=2"
    },
    "data": [
        {
            "id": 193,
            "api_model": "printed-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/printed-catalogs/193",
            "title": "Material Meanings: Selections from the Constance R. Caplan Collection",
            "is_published": false,
            "type": null,
            ...
        },
        {
            "id": 194,
            "api_model": "printed-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/printed-catalogs/194",
            "title": "El Greco: Ambition and Defiance",
            "is_published": false,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

GET /printed-catalogs/search

Search printed-catalogs data in the aggregator.

Available parameters:

  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.

Example request: https://aggregator-data.artic.edu/api/v1/printed-catalogs/search
Example output:

{
    "preference": null,
    "pagination": {
        "total": 179,
        "limit": 10,
        "offset": 0,
        "total_pages": 18,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "printed-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/printed-catalogs/4",
            "id": 4,
            "title": "The Art Institute of Chicago: The Essential Guide",
            "timestamp": "2020-02-18T07:36:29-06:00"
        },
        {
            "_score": 1,
            "api_model": "printed-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/printed-catalogs/5",
            "id": 5,
            "title": "Roy Lichtenstein: A Retrospective",
            "timestamp": "2020-02-18T07:36:29-06:00"
        },
        {
            "_score": 1,
            "api_model": "printed-catalogs",
            "api_link": "https://aggregator-data.artic.edu/api/v1/printed-catalogs/6",
            "id": 6,
            "title": "Dawoud Bey: Harlem, U.S.A.",
            "timestamp": "2020-02-18T07:36:29-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    }
}

GET /printed-catalogs/{id}

A single printed-catalog by the given identifier.

Example request: https://aggregator-data.artic.edu/api/v1/printed-catalogs/191?limit=2
Example output:

{
    "data": {
        "id": 191,
        "api_model": "printed-catalogs",
        "api_link": "https://aggregator-data.artic.edu/api/v1/printed-catalogs/191",
        "title": "Rubens, Rembrandt, and Drawing in the Golden Age",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0-rc10"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "https://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "https://shop.artic.edu/item.aspx?productId="
    }
}

Generated by php artisan docs:endpoints on 2020-02-21 11:54:23