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)
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/-blank-icon-500r.gif",
      "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": {
    "limit": 10,
    "page": 0,
    "total": 93308
  },
  "time-elapsed": 0.32520341873168945
}

/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.03882288932800293,
  "translations": {
    "fr": {
      "name": null
    }
  }
}