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:
Attribute |
Type |
Description |
items |
array |
... ☞ User |
meta |
|
... ☞ MetaUser |
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 |
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:
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 |
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
}
}
}