2021-03-21 14:26:07 +00:00
![twitter-profile-pic ](logo.png )
2018-01-14 13:25:32 +00:00
> Get a twitter profile pic using a given handle
2021-03-21 14:26:07 +00:00
Available at https://twitter-profile-pic.cluster.fun/
2018-01-14 13:25:32 +00:00
## Features
* Multiple image size support (currently supported: `normal` , `bigger` , `mini` , `original` , `200x200` , `400x400` )
* JSON support using `application/json` content type header
* Returns a default profile pic for unknown users
## Example: HTML
Code:
```
2021-03-21 14:26:07 +00:00
< img src = "https://twitter-profile-pic.cluster.fun/marcus_noble_?size=normal" / >
2018-01-14 13:25:32 +00:00
```
Result:
2021-03-21 14:26:07 +00:00
![](https://twitter-profile-pic.cluster.fun/marcus_noble_?size=normal)
2018-01-14 13:25:32 +00:00
## Example: JSON
cURL Request:
```
curl -X GET \
2021-03-21 14:26:07 +00:00
https://twitter-profile-pic.cluster.fun/marcus_noble_ \
2018-01-14 13:25:32 +00:00
-H 'cache-control: no-cache' \
-H 'content-type: application/json' \
-H 'postman-token: 680d968e-9b13-85c8-f7d5-9b48a333702f'
```
Result:
```
{
"normal": "https://pbs.twimg.com/profile_images/776738772759277569/hfaM5zhA_normal.jpg",
"bigger": "https://pbs.twimg.com/profile_images/776738772759277569/hfaM5zhA_bigger.jpg",
"mini": "https://pbs.twimg.com/profile_images/776738772759277569/hfaM5zhA_mini.jpg",
"original": "https://pbs.twimg.com/profile_images/776738772759277569/hfaM5zhA.jpg",
"200x200": "https://pbs.twimg.com/profile_images/776738772759277569/hfaM5zhA_200x200.jpg",
"400x400": "https://pbs.twimg.com/profile_images/776738772759277569/hfaM5zhA_400x400.jpg"
}
```
2018-01-14 13:50:34 +00:00
## Requirements
[Redis ](https://redis.io/ ) is required if caching is wanted. You will also need Twitter credentials that can be created here: [https://apps.twitter.com/ ](https://apps.twitter.com/ )
Environment Variables:
```
TWITTER_CONSUMER_KEY=
TWITTER_CONSUMER_SECRET=
TWITTER_ACCESS_TOKEN_KEY=
TWITTER_ACCESS_TOKEN_SECRET=
REDIS_URL=
```