scrapy.Item

Base class for scraped items.

In Scrapy, an object is considered an item if it is an instance of either Item or dict, or any subclass. For example, when the output of a spider callback is evaluated, only instances of Item or dict are passed to :ref:`item pipelines <topics-item-pipeline>`.

If you need instances of a custom class to be considered items by Scrapy, you must inherit from either Item or dict.

Items must declare Field attributes, which are processed and stored in the fields attribute. This restricts the set of allowed field names and prevents typos, raising KeyError when referring to undefined fields. Additionally, fields can be used to define metadata and control the way data is processed internally. Please refer to the :ref:`documentation about fields <topics-items-fields>` for additional information.

Unlike instances of dict, instances of Item may be :ref:`tracked <topics-leaks-trackrefs>` to debug memory leaks.