The API for LobbyFacts is made to allow easy access to up-to-date, structured information about registered interests, persons and other organisations.
It provides both entity-centric access which can be used to find and retrieve data about individual data items as well as a reporting interface which exposes pre-defined views of the data, including aggregated overviews per country etc.
A few simple conventions apply throughout the API:
callback=argument to each request
The API exposes a number of entities. For each domain entity, there are
view action will return a deep representation
of the specified entity, which often contains shallow
representations of associated objects.
index pages, a shallow representation of
the data is returned, containing no associated entities and a limited
set of attributes. Users can set an
text/csv or add
.csv to the URL
to retrieve a CSV-encoded form of the data.
index operation supports a number of query parameters:
limit(default: 50, maximum 500) limits the number of entries returned in a single page.
offset(default: 0) specifies the number of records to skip before returning a set of entries.
filtercan be specified multiple times. The value of the argument has the format
field:value, i.e. the specified value applied as a filter to the given field.
qparameter, which will perform a full-text search of the data, looking for the specified terms.
Entities represent unique actors represented in the database. They mainly
exist to deduplicate and link between different types of records, such as a
person or some other domain object
which refer to the same physical thing.
Representatives are the companies, trade associations or lobbying firms
which are registered in the lobby register. Most other information is in some
way linked to them. They have a 1:1 relationship to
Individuals appear either as legal contact or head of a
or through an
accreditation, which permits them to enter the
European Parliament. Persons have a 1:1 link to
Categories reflect the type of a particular
represenative. They have two
levels, and categories on the second level link up to the more general group.
Organisations are not well specified, but they can represent the clients or members of
representative. They have a 1:1 relationship to
represenative has a contact country, which is the place from where its
lobbying operation is run (thus not necessarily the location of its headquarters).
represenative has to make a financial statement detailing its
revenues and expenses on lobbying activities once a year. Different fields on
this are set for companies, NGO and law firms.
represenative can have multiple
persons associated with it
that are authorized to enter the European Parliament as lobbyists.