Categories endpoint
This section gives you information about the categories used by projects or users in Goteo.org
/categories/
Obtains a list of categories.
curl -i --basic --user "user:key" https://api.goteo.org/v1/categories/
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 categories used in projects assigned in that nodes |
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 categories used in that projects |
from_date |
string |
Filter from date. Ex. "2013-01-01". Restricts the list to the categories used in projects created between that dates |
to_date |
string |
Filter until date.. Ex. "2014-01-01". Restricts the list to the categories used in projects created between that dates |
category |
integer |
Filter by category. Multiple categories can be specified. Restricts the list to the categories specified |
social_commitment |
integer |
Filter by social commitment. Multiple social commitments can be specified. Restricts the list to the categories matching with that social commitment(s) |
sdg |
integer |
Filter by Sustainable Development Goal. Multiple SDGs can be specified. Restricts the list to the categories in that SDG(s) |
footprint |
integer |
Filter by footprint. Multiple footprints can be specified. Restricts the list to the categories in that footprint(s) |
lang |
string |
Get results by specified lang. Multiple langs can be specified |
location |
number |
Filter by project location (Latitude,longitude,Radius in Km). Restricts the list to the categories used in projects geolocated in that area |
Response values:
Attribute |
Type |
Description |
description |
string |
Category short description |
id |
string |
Category unique identifier |
name |
string |
Category name |
social-commitment |
|
Non-economical detailed list of necessities ☞ SocialCommitment |
total-projects |
integer |
Number of published projects in the category |
total-users |
integer |
Number of users interested in the category |
Attribute |
Type |
Description |
from_date |
string |
Only if filtering by from_date |
lang |
array |
Only if filtering by lang |
location |
array |
Only if filtering by location |
node |
array |
Only if filtering by node |
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": [
{
"description": "Projects that promote social change, resolve problems with or strengthen human relationshiops in order to achieve better well-being.",
"id": 2,
"name": "Social",
"social-commitment": {
"description": "Solidario",
"icon_url": "https://goteo.org/img/medium/1-solidario-1.png",
"id": 1,
"name": "Solidario"
},
"total-projects": 691,
"total-users": 12699
},
{
"description": "Projects whose objective is to inform, denounce and/or communicate (for example, civic journalism, documentaries, blogs, radio programs).",
"id": 6,
"name": "Communications",
"social-commitment": {
"description": "Periodismo independiente",
"icon_url": "https://goteo.org/img/medium/5-periodismo-1.png",
"id": 5,
"name": "Periodismo independiente"
},
"total-projects": 286,
"total-users": 5043
},
{
"description": "Technical development of software, hardware, tools, etc in order to solve concrete problems or needs.",
"id": 7,
"name": "Technological",
"social-commitment": {
"description": "Software libre",
"icon_url": "https://goteo.org/img/medium/2-software-libre-1.png",
"id": 2,
"name": "Software libre"
},
"total-projects": 190,
"total-users": 5914
},
{
"description": "Projects that are business initiatives, and that hope to generate profits.",
"id": 9,
"name": "Commercial",
"social-commitment": {
"description": "Generar empleo",
"icon_url": "https://goteo.org/img/medium/4b-empleo.png",
"id": 3,
"name": "Generar empleo"
},
"total-projects": 153,
"total-users": 5504
},
{
"description": "Projects whose most important objective is formation or learning. ",
"id": 10,
"name": "Educational",
"social-commitment": {
"description": "Educativo",
"icon_url": "https://goteo.org/img/medium/6-educativo-1.png",
"id": 6,
"name": "Educativo"
},
"total-projects": 530,
"total-users": 9563
},
{
"description": "Projects with artistic or cultural objectives.",
"id": 11,
"name": "Cultural",
"social-commitment": {
"description": "Crear cultura",
"icon_url": "https://goteo.org/img/medium/7--crear-cultura-1.png",
"id": 7,
"name": "Crear cultura"
},
"total-projects": 552,
"total-users": 9393
},
{
"description": "Projects that are related to the care of the environment, sustainability, and/or biological diversity.\r\n",
"id": 13,
"name": "Ecological",
"social-commitment": {
"description": "Acci\u00f3n por el clima",
"icon_url": "https://goteo.org/img/medium/8-ecologico-1.png",
"id": 8,
"name": "Acci\u00f3n por el clima"
},
"total-projects": 330,
"total-users": 7970
},
{
"description": "Studies or research, projects that look for answers, solutions, new explanations.",
"id": 14,
"name": "Scientific",
"social-commitment": {
"description": null,
"icon_url": null,
"id": 0,
"name": null
},
"total-projects": 108,
"total-users": 4625
},
{
"description": null,
"id": 16,
"name": "Design",
"social-commitment": {
"description": null,
"icon_url": null,
"id": 0,
"name": null
},
"total-projects": 81,
"total-users": 885
}
],
"meta": {
"lang": [
"en"
],
"total": 9
},
"time-elapsed": 2.4537246227264404
}