Apontador developers
Sign in

Users Endpoints

https://api.apontador.com.br/v2/users/{userId}

Method: GET

Authorization: You can use your access_token from application or from user

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • {userId}: the user id
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/USER_ID

If successful, this call will return:

{
    "user": {
        "id": "USER_ID",
        "link": {
            "rel": "self",
            "uri": "https://api.apontador.com.br/v2/users/USER_ID"
        },
        "name": "christo;",
        "birth": 16-08-1982,
        "gender": "M",
        "photos": {
            "small": "http://aptuser.s3.amazonaws.com/2024859918_s.jpg",
            "medium": "http://aptuser.s3.amazonaws.com/2024859918_m.jpg",
            "large": "http://aptuser.s3.amazonaws.com/2024859918_b.jpg",
            "original": "http://aptuser.s3.amazonaws.com/2024859918_o.jpg"
        },
        "statistics": {
            "reviews": 859,
            "places": 90,
            "photos": 854,
            "checkins": 1085
        }
    }
}
			
https://api.apontador.com.br/v2/users/me

Method: GET

Authorization: You must use user's access_token.

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/me

If successful, this call will return:

{
    "user": {
        "id": "USER_ID",
        "link": {
            "rel": "self",
            "uri": "https://api.apontador.com.br/v2/users/USER_ID"
        },
        "name": "USER_NAME",
        "birth": 16-08-1982,
        "gender": "M",
        "photos": {
            "small": "http://aptuser.s3.amazonaws.com/2024859918_s.jpg",
            "medium": "http://aptuser.s3.amazonaws.com/2024859918_m.jpg",
            "large": "http://aptuser.s3.amazonaws.com/2024859918_b.jpg",
            "original": "http://aptuser.s3.amazonaws.com/2024859918_o.jpg"
        },
        "statistics": {
            "reviews": 859,
            "places": 90,
            "photos": 854,
            "checkins": 1085
        }
    }
}
			
https://api.apontador.com.br/v2/users/{userId}/following

Method: GET

Authorization: You can use your access_token from application or from user.

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • {userId}: the user id
  • rows: (optional) the default is 10 and maximum 50
  • start: (optional) the default is 0, it's used for pagination
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/USER_ID/following

If successful, this call will return:

{
    "userResults": {
        "header": {
            "found": 13, 
            "next": "https://api.apontador.com.br/v2/users/USER_ID/following?rows=2&start=4", 
            "previous": "https://api.apontador.com.br/v2/users/USER_ID/following?rows=2&start=0", 
            "rows": 2, 
            "start": 2
        }, 
        "users": [
            {
                "birth": 13-01-1988, 
                "gender": "M", 
                "id": "USER_ID", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                }, 
                "name": "Leonardo Andreucci", 
                "photos": {
                    "large": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_b.jpg", 
                    "medium": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_m.jpg", 
                    "small": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1755, 
                    "photos": 2498, 
                    "places": 570, 
                    "reviews": 935
                }
            }, 
            {
                "birth": 13-01-1968, 
                "gender": "M", 
                "id": "8972911185", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/8972911185"
                }, 
                "name": "Eher", 
                "photos": {
                    "large": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_b.jpg", 
                    "medium": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_m.jpg", 
                    "small": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1380, 
                    "photos": 326, 
                    "places": 104, 
                    "reviews": 124
                }
            }
        ]
    }
}
			
https://api.apontador.com.br/v2/users/{userId}/followers

Method: GET

Authorization: You can use your access_token from application or from user.

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • {userId}: the user id
  • rows: (optional) the default is 10 and maximum 50
  • start: (optional) the default is 0, it's used for pagination
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/USER_ID/followers

If successful, this call will return:

{
    "userResults": {
        "header": {
            "found": 13, 
            "next": "https://api.apontador.com.br/v2/users/USER_ID/followers?rows=2&start=4", 
            "previous": "https://api.apontador.com.br/v2/users/USER_ID/followers?rows=2&start=0", 
            "rows": 2, 
            "start": 2
        }, 
        "users": [
            {
                "birth": 13-01-1988, 
                "gender": "M", 
                "id": "USER_ID", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                }, 
                "name": "Leonardo Andreucci", 
                "photos": {
                    "large": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_b.jpg", 
                    "medium": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_m.jpg", 
                    "small": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1755, 
                    "photos": 2498, 
                    "places": 570, 
                    "reviews": 935
                }
            }, 
            {
                "birth": 13-01-1968, 
                "gender": "M", 
                "id": "8972911185", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/8972911185"
                }, 
                "name": "Eher", 
                "photos": {
                    "large": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_b.jpg", 
                    "medium": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_m.jpg", 
                    "small": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1380, 
                    "photos": 326, 
                    "places": 104, 
                    "reviews": 124
                }
            }
        ]
    }
}
			
https://api.apontador.com.br/v2/users/me/following

Method: GET

Authorization: You must use user's access_token.

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • rows: (optional) the default is 10 and maximum 50
  • start: (optional) the default is 0, it's used for pagination
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/me/following

If successful, this call will return:

{
    "userResults": {
        "header": {
            "found": 13, 
            "next": "https://api.apontador.com.br/v2/users/me/following?rows=2&start=4", 
            "previous": "https://api.apontador.com.br/v2/users/me/following?rows=2&start=0", 
            "rows": 2, 
            "start": 2
        }, 
        "users": [
            {
                "birth": 13-01-1988, 
                "gender": "M", 
                "id": "USER_ID", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                }, 
                "name": "Leonardo Andreucci", 
                "photos": {
                    "large": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_b.jpg", 
                    "medium": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_m.jpg", 
                    "small": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1755, 
                    "photos": 2498, 
                    "places": 570, 
                    "reviews": 935
                }
            }, 
            {
                "birth": 13-01-1968, 
                "gender": "M", 
                "id": "8972911185", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/8972911185"
                }, 
                "name": "Eher", 
                "photos": {
                    "large": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_b.jpg", 
                    "medium": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_m.jpg", 
                    "small": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1380, 
                    "photos": 326, 
                    "places": 104, 
                    "reviews": 124
                }
            }
        ]
    }
}
			
https://api.apontador.com.br/v2/users/me/followers

Method: GET

Authorization: You must use user's access_token.

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • rows: (optional) the default is 10 and maximum 50
  • start: (optional) the default is 0, it's used for pagination
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/me/followers

If successful, this call will return:

{
    "userResults": {
        "header": {
            "found": 13, 
            "next": "https://api.apontador.com.br/v2/users/me/followers?rows=2&start=4", 
            "previous": "https://api.apontador.com.br/v2/users/me/followers?rows=2&start=0", 
            "rows": 2, 
            "start": 2
        }, 
        "users": [
            {
                "birth": 13-01-1988, 
                "gender": "M", 
                "id": "USER_ID", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                }, 
                "name": "Leonardo Andreucci", 
                "photos": {
                    "large": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_b.jpg", 
                    "medium": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_m.jpg", 
                    "small": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1755, 
                    "photos": 2498, 
                    "places": 570, 
                    "reviews": 935
                }
            }, 
            {
                "birth": 13-01-1968, 
                "gender": "M", 
                "id": "8972911185", 
                "link": {
                    "rel": "self", 
                    "uri": "https://api.apontador.com.br/v2/users/8972911185"
                }, 
                "name": "Eher", 
                "photos": {
                    "large": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_b.jpg", 
                    "medium": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_m.jpg", 
                    "small": "http://aptuser.s3.amazonaws.com/8972911185_7873303855572550_s.jpg"
                }, 
                "statistics": {
                    "checkins": 1380, 
                    "photos": 326, 
                    "places": 104, 
                    "reviews": 124
                }
            }
        ]
    }
}
			
https://api.apontador.com.br/v2/users/{userId}/following/{followingId}

Method: GET

Authorization: You must use user's access_token.

Parameters:

  • {userId}: the user id
  • {followingId}: the user id you want to check if is present in following list 
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/USER_ID/following/FOLLOWING_USER_ID

If the followingId is present in the list, this call will return HTTP_STATUS_CODE: 200

If the followingId is not present in the list, this call will return HTTP_STATUS_CODE: 404 Not Found

https://api.apontador.com.br/v2/users/{userId}/places/checkins

Method: GET

Authorization: You can use your access_token from application or from user

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • {userId}: the user id
  • rows: (optional) the default is 10 and maximum 50
  • start: (optional) the default is 0, it's used for pagination
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/USER_ID/places/checkins?wt=json&rows=2&start=2

If successful, this call will return:

{
    "checkinResults": {
        "header": {
            "found": 17,
            "rows": 2,
            "start": 2,
            "next": "https://api.apontador.com.br/v2/users/USER_ID/places/checkins?wt=json&rows=2&start=4",
            "previous": "https://api.apontador.com.br/v2/users/USER_ID/places/checkins?wt=json&rows=2&start=0"
        },
        "checkins": [
            {
                "source": "p1Wd7hw36lyUUKgsGaM_sukH2vXXxPgLvPOIsPwX16k~",
                "creation": {
                    "author": {
                        "id": "USER_ID",
                        "link": {
                            "rel": "self",
                            "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                        },
                        "name": "JOAO",
                        "photo": "https://graph.facebook.com/1000004221343902/picture?type=normal"
                    },
                    "created": 1359540694000
                },
                "place": {
                    "id": "9M56U2J8",
                    "name": "Academia de Ginástica Quito",
                    "link": {
                        "rel": "/linkrels/search/getByPlaceId",
                        "uri": "https://api.apontador.com.br/v2/places/9M56U2J8"
                    }
                }
            },
            {
                "source": "p1Wd7hw36lyUUKgsGaM_sukH2vXXxPgLvPOIsPwX16k~",
                "creation": {
                    "author": {
                        "id": "USER_ID",
                        "link": {
                            "rel": "self",
                            "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                        },
                        "name": "JOAO",
                        "photo": "https://graph.facebook.com/1000004221343902/picture?type=normal"
                    },
                    "created": 1358606266000
                },
                "place": {
                    "id": "C40431391A180C180A",
                    "name": "Consulado de Moema",
                    "link": {
                        "rel": "/linkrels/search/getByPlaceId",
                        "uri": "https://api.apontador.com.br/v2/places/C40431391A180C180A"
                    }
                }
            }
        ]
    }
}
			
https://api.apontador.com.br/v2/users/{userId}/places/reviews

Method: GET

Authorization: You can use your access_token from application or from user

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • {userId}: the user id
  • rows: (optional) the default is 10 and maximum 50
  • start: (optional) the default is 0, it's used for pagination
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/USER_ID/places/reviews?wt=json&rows=2&start=2

If successful, this call will return:

{
    "reviewResults": {
        "header": {
            "found": 935,
            "rows": 2,
            "start": 2,
            "next": "https://api.apontador.com.br/v2/users/USER_ID/places/reviews?wt=json&rows=2&start=4",
            "previous": "https://api.apontador.com.br/v2/users/USER_ID/places/reviews?wt=json&rows=2&start=0"
        },
        "reviews": [
            {
                "id": "812589",
                "link": {
                    "rel": "self",
                    "uri": "https://api.apontador.com.br/v2/reviews/812589"
                },
                "text": "Almocei um dia no restaurante Manzuá, ele não é um dos mais famosos mas muitos restaurantes de Jericoacoara só abrem para o jantar. Não havia muita expectativa, mas o peixe com camarão estava muito bom e o ambiente é agradável, vale conhecer!",
                "source": "p1Wd7hw36lzFhNN5cgdn6OeqtrUSBGGFjgruLyUiEIM~",
                "statistics": {
                    "rating": "4",
                    "thumbsUp": "0"
                },
                "creation": {
                    "author": {
                        "id": "USER_ID",
                        "link": {
                            "rel": "self",
                            "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                        },
                        "name": "Leonardo Andreucci",
                        "photo": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_m.jpg"
                    },
                    "created": 1361559858000
                },
                "place": {
                    "id": "C40822291B1F2T1F25",
                    "name": "Manzuá",
                    "link": {
                        "rel": "/linkrels/search/getByPlaceId",
                        "uri": "https://api.apontador.com.br/v2/places/C40822291B1F2T1F25"
                    }
                }
            },
            {
                "id": "812577",
                "link": {
                    "rel": "self",
                    "uri": "https://api.apontador.com.br/v2/reviews/812577"
                },
                "text": "A sorveteria Gelato e Grano em Jericoacoara é excelente, fui lá quase todos os dias! O melhor é o de chocolate extra black, sensacional! Não deixe de conhecer!",
                "source": "p1Wd7hw36lzFhNN5cgdn6OeqtrUSBGGFjgruLyUiEIM~",
                "statistics": {
                    "rating": "5",
                    "thumbsUp": "0"
                },
                "creation": {
                    "author": {
                        "id": "USER_ID",
                        "link": {
                            "rel": "self",
                            "uri": "https://api.apontador.com.br/v2/users/USER_ID"
                        },
                        "name": "Leonardo Andreucci",
                        "photo": "https://aptuser.s3.amazonaws.com/USER_ID_30411688244660_m.jpg"
                    },
                    "created": 1361559359000
                },
                "place": {
                    "id": "C40497091B1F2Q1F21",
                    "name": "Gelato e Grano",
                    "link": {
                        "rel": "/linkrels/search/getByPlaceId",
                        "uri": "https://api.apontador.com.br/v2/places/C40497091B1F2Q1F21"
                    }
                }
            }
        ]
    }
}
			
https://api.apontador.com.br/v2/users/{email}/verify

Method: GET

Authorization: You must use a trusted client access_token.

Parameters:

  • email: the user email
curl -v -X GET -H "Accept: application/xml" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/users/{email}/verify

If email exist, this call will return HTTP Status 200 (OK).

If email does not exist, this call will return HTTP Status 404 (NOT FOUND).