{"id":17036219,"url":"https://github.com/lorey/socials-api","last_synced_at":"2025-04-12T13:02:07.693Z","repository":{"id":45439452,"uuid":"261227487","full_name":"lorey/socials-api","owner":"lorey","description":"👨‍👩‍👧‍👦 (Rest) API to extract social media profiles from websites or specific URLs","archived":false,"fork":false,"pushed_at":"2022-12-08T09:46:05.000Z","size":115,"stargazers_count":19,"open_issues_count":6,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-10T20:13:10.440Z","etag":null,"topics":["api","django","django-rest-framework","python","rest-api","scraping","social-media-profiles","socials"],"latest_commit_sha":null,"homepage":"http://socials.karllorey.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lorey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-04T15:45:24.000Z","updated_at":"2025-01-08T21:23:54.000Z","dependencies_parsed_at":"2023-01-25T06:15:08.136Z","dependency_job_id":null,"html_url":"https://github.com/lorey/socials-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lorey","download_url":"https://codeload.github.com/lorey/socials-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248571915,"owners_count":21126522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","django","django-rest-framework","python","rest-api","scraping","social-media-profiles","socials"],"created_at":"2024-10-14T08:49:44.372Z","updated_at":"2025-04-12T13:02:07.659Z","avatar_url":"https://github.com/lorey.png","language":"Python","readme":"# socials API: extract social media profiles\nThe [socials API](http://socials.karllorey.com) allows you to extract social media profiles from urls.\nIt is an API version of my library called [socials for Python](https://github.com/lorey/socials).\n\nTry it at [socials.karllorey.com](http://socials.karllorey.com).\n\n## Example\nRequesting `http://socials.karllorey.com/api/fetch-url` \nwith a POST request and `url=https://karllorey.com` as parameter \nwill return all social media profiles \nlinked from [karllorey.com](https://karllorey.com) (my personal website).\nFor example, with cURL:\n```bash\ncurl --data \"url=https://karllorey.com\" http:/socials.karllorey.com/api/fetch-url\n```\n\nResponse:\n\n```json\n{\n    \"matches_per_platform\": {\n        \"facebook\": [],\n        \"twitter\": [\n            \"https://twitter.com/karllorey\"\n        ],\n        \"linkedin\": [],\n        \"github\": [\n            \"https://github.com/lorey/karllorey.com\",\n            \"https://github.com/lorey\"\n        ],\n        \"email\": []\n    }\n}\n```\n\n## Test it (on the website)\nThere's a page, [socials.karllorey.com/try](http://socials.karllorey.com/try), \nwhere you can preview the functionality.\n\n## Test it (with the browsable API)\nDjango REST Framework offers a browsable API where you can test all functionality in the browser.\n\n1. Go to [socials.karllorey.com/api/fetch-url](http://socials.karllorey.com/api/fetch-url)\n2. Select for `Media type`: `application/x-www-form-urlencoded`\n3. Enter in `Content`: `url=https://karllorey.com` or any other url\n\n![Screenshot of socials API's browsable API](.github/socials-browsable-api.png)\n\n## Set it up for yourself\nsocials API is dockerized and can be set up via docker-compose within seconds:\n```bash\ndocker-compose build\ndocker-compose up -f docker-compose.yml -f docker-compose.prod.yml -d\n```\n\nIt should now be accessible at port 80.\nThe development version you get with `docker-compose up` is at port 8016.\nMake sure to adapt the [rate limit in `socials_api/settings.py`](socials_api/settings.py).\n\nI have personal ansible and terraform files for deployment via docker-compose on AWS.\nReach out if you're interested.\n\n# References\n- [socials](https://github.com/lorey/socials), a Python library to check if urls are social media profiles\n- [social-media-profiles-regexs](https://github.com/lorey/social-media-profiles-regexs):\n  extract urls of social media profiles with regular expressions\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Florey%2Fsocials-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Florey%2Fsocials-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Florey%2Fsocials-api/lists"}