Users endpoint

This section gives you information about users in Goteo.org

/users/

Obtains a list of users.

curl -i --basic --user "user:key" https://api.goteo.org/v1/users/

Filters available:

The standard set of filters applies to this endpoint with these particulars:

Attribute	Type	Description
node	string	Filter by individual node(s). Multiple nodes can be specified. Restricts the list to the users originally created in that node(s)
call	string	Filter by individual matchfunding call(s). Multiple calls can be specified. Restricts the list to the projects originally created in that call(s)
project	string	Filter by individual project(s). Multiple projects can be specified. Restricts the list to the users that have either collaborate or contributed (financially) to that project(s).
lang	string	Get results by specified lang. Multiple langs can be specified
from_date	string	Filter from date. Ex. "2013-01-01". Restricts the list to the users created in that range
to_date	string	Filter until date.. Ex. "2014-01-01". Restricts the list to the users created in that range
category	integer	Filter by user categories. Multiple categories can be specified. Restricts the list to the users that have interests in that category(ies)
social_commitment	integer	Filter by project social commitment. Multiple social commitments can be specified. Restricts the list to the users that have invested in projects with that social commitment(s)
sdg	integer	Filter by project Sustainable Development Goal. Multiple SDGs can be specified. Restricts the list to the users that have invested in projects with that SDG(s)
footprint	integer	Filter by project footprint. Multiple footprints can be specified. Restricts the list to the users that have invested in projects with that footprint(s)
page	integer	Page number (starting at 1) if the result can be paginated
limit	integer	Page limit (maximum 50 results, defaults to 10) if the result can be paginated

location does not applies to this endpoint.
lang does not applies in this endpoint

Response values:

ResponseUser

Attribute	Type	Description
items	array	... ☞ User
meta		... ☞ MetaUser

User

Attribute	Type	Description
date-created	string	Date when the user was created RFC822 format
id	string	User unique identifier
name	string	Name of the user
node	string	Node where the user was created originally
profile-image-url	string	URL with the avatar (image) of the user
profile-url	string	URL for the user profile

MetaUser

Attribute	Type	Description
category	array	Only if filtering by category
from_date	string	Only if filtering by from_date
lang	array	Only if filtering by lang
limit	integer	Limit of results per page when retrieving a collection
node	array	Only if filtering by node
page	integer	Current page, `0` based (first page is zero)
project	array	Only if filtering by project
to_date	string	Only if filtering by to_date
total	integer	Total elements available for the collection

Response body:

{
  "items": [
    {
      "date-created": "Mon, 05 Sep 2016 15:47:52 +0200",
      "id": "",
      "name": "rober",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/la_gota.png",
      "profile-url": "https://goteo.org/user/profile/"
    },
    {
      "date-created": "Tue, 05 Jun 2012 09:04:38 +0200",
      "id": "-angellg",
      "name": "Angel Lopez",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/signs-26.jpg",
      "profile-url": "https://goteo.org/user/profile/-angellg"
    },
    {
      "date-created": "Tue, 05 Jun 2012 09:56:19 +0200",
      "id": "-aserrano",
      "name": "Antonio",
      "node": "andalucia",
      "profile-image-url": "https://goteo.org/img/medium/sin-ti-tulo.jpg",
      "profile-url": "https://goteo.org/user/profile/-aserrano"
    },
    {
      "date-created": "Sun, 20 Nov 2011 13:09:06 +0100",
      "id": "-blank",
      "name": "_blank",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/",
      "profile-url": "https://goteo.org/user/profile/-blank"
    },
    {
      "date-created": "Fri, 01 Jun 2012 19:11:44 +0200",
      "id": "-cafeambllet",
      "name": "caf\u00e8ambllet",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/entradacafer.jpg",
      "profile-url": "https://goteo.org/user/profile/-cafeambllet"
    },
    {
      "date-created": "Tue, 05 Jun 2012 09:34:01 +0200",
      "id": "-enlared",
      "name": "\u20acSPANISH DR\u20acAM",
      "node": "barcelona",
      "profile-image-url": "https://goteo.org/img/medium/-d2.jpg",
      "profile-url": "https://goteo.org/user/profile/-enlared"
    },
    {
      "date-created": "Wed, 08 Feb 2012 23:36:27 +0100",
      "id": "-erasehead-",
      "name": "Elisa",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/la_gota.png",
      "profile-url": "https://goteo.org/user/profile/-erasehead-"
    },
    {
      "date-created": "Sat, 05 Jan 2013 11:27:57 +0100",
      "id": "-leticia-",
      "name": "Leticia",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/wonderwoman.jpg",
      "profile-url": "https://goteo.org/user/profile/-leticia-"
    },
    {
      "date-created": "Wed, 06 Jun 2012 01:29:49 +0200",
      "id": "-manrike",
      "name": "_Manrike",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/la_gota.png",
      "profile-url": "https://goteo.org/user/profile/-manrike"
    },
    {
      "date-created": "Mon, 15 Oct 2012 19:24:17 +0200",
      "id": "-mtiago",
      "name": "Mamen \u267a",
      "node": "goteo",
      "profile-image-url": "https://goteo.org/img/medium/1504985-498184073669699-8765612512546226104-n.jpg",
      "profile-url": "https://goteo.org/user/profile/-mtiago"
    }
  ],
  "meta": {
    "lang": [
      "en"
    ],
    "limit": 10,
    "page": 0,
    "total": 188722
  },
  "time-elapsed": 6.725291728973389
}

/users/{USER_ID}

Gets information about a single user.

curl -i --basic --user "user:key" https://api.goteo.org/v1/users/goteo

Filters available:

No filters are available in this endpoint
{USER_ID} must be the unique identifier of the user

Response values:

UserFull

Attribute	Type	Description
about	string	User's about text
amount-public-invested	number	Amount of money invested in any project (excluding anonymous investions)
date-created	string	Date when the user was created RFC822 format
id	string	User unique identifier
lang	string	Language for the user's texts description
name	string	Name of the user
node	string	Node where the user was created originally
profile-image-url	string	URL with the avatar (image) of the user
profile-url	string	URL for the user profile
projects-collaborated	number	Number of project the user has interacted
projects-public-invested	number	Number of projects where the user has invested (excluding anonymous investions)
projects-published	number	Number of project the user has created and published
translations	array	All available translations in a list indexed by language in ISO 639-1 format ☞ UserTranslation

UserTranslation

Attribute	Type	Description
about	string	User's about text translated (if any)
name	string	Name of the user translated (if any)

Response body:

{
  "about": "Este perfil representa al equipo que administra la plataforma Goteo, desde el que nos comunicamos con todos los usuarios y usuarias. Si quieres contactar con nosotras escribe desde la secci\u00f3n de \"Contacto\" (en el pie de la p\u00e1gina) o bien v\u00eda Twitter (@gteofunding)",
  "amount-public-invested": 0.0,
  "date-created": "Sat, 20 Aug 2011 13:57:14 +0200",
  "id": "goteo",
  "lang": "es",
  "name": "Goteo",
  "node": "goteo",
  "profile-image-url": "https://goteo.org/img/medium/goteo-twitter7r.png",
  "profile-url": "https://goteo.org/user/profile/goteo",
  "projects-collaborated": 7,
  "projects-public-invested": 0,
  "projects-published": 0,
  "time-elapsed": 0.05135011672973633,
  "translations": {
    "fr": {
      "name": null
    }
  }
}