{"id":23286425,"url":"https://github.com/httparchive/tech-report-apis","last_synced_at":"2025-04-06T15:32:49.033Z","repository":{"id":185129313,"uuid":"610497281","full_name":"HTTPArchive/tech-report-apis","owner":"HTTPArchive","description":"APIs for the HTTP Archive Technology Report","archived":false,"fork":false,"pushed_at":"2024-03-01T02:34:15.000Z","size":280,"stargazers_count":2,"open_issues_count":10,"forks_count":0,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-04-13T21:47:58.935Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HTTPArchive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-03-06T22:22:28.000Z","updated_at":"2023-12-07T14:20:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"8c3cc7a8-7915-4bdc-9b10-1736b655c5ed","html_url":"https://github.com/HTTPArchive/tech-report-apis","commit_stats":{"total_commits":67,"total_committers":3,"mean_commits":"22.333333333333332","dds":0.04477611940298509,"last_synced_commit":"fde156bac81e4f53e8a94843e45d3e7bc85358c4"},"previous_names":["httparchive/tech-report-apis"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HTTPArchive%2Ftech-report-apis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HTTPArchive%2Ftech-report-apis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HTTPArchive%2Ftech-report-apis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HTTPArchive%2Ftech-report-apis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HTTPArchive","download_url":"https://codeload.github.com/HTTPArchive/tech-report-apis/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247502850,"owners_count":20949339,"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":[],"created_at":"2024-12-20T02:12:25.569Z","updated_at":"2025-04-06T15:32:49.021Z","avatar_url":"https://github.com/HTTPArchive.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tech-report-apis\n\nAPIs for the HTTP Archive Technology Report\n\n## API\n\n## Endpoints\n\n### `GET /adoption`\n\n#### Parameters\n\nThe following parameters can be used to filter the data:\n\n- `geo` (`required`): A string representing the geographic location.\n- `technology` (`required`): A comma-separated string representing the technology name(s).\n- `rank` (`required`): An string representing the rank.\n- `start` (optional): A string representing the start date in the format `YYYY-MM-DD`.\n- `end` (optional): A string representing the end date in the format `YYYY-MM-DD`.\n\n#### Response\n\n```bash\ncurl --request GET \\\n  --url 'https://{{HOST}}/v1/adoption?start=2023-01-01\u0026end=2023-09-01\u0026geo=Mexico\u0026technology=GoCache\u0026rank=ALL'\n```\n\nReturns a JSON object with the following schema:\n\n```json\n[\n    {\n        \"technology\": \"GoCache\",\n        \"geo\": \"Mexico\",\n        \"date\": \"2023-06-01\",\n        \"rank\": \"ALL\",\n        \"adoption\": {\n            \"mobile\": 19,\n            \"desktop\": 11\n        }\n    },\n    ...\n]\n```\n\n### `GET /categories`\n\nThis endpoint can return a full list of categories names or a categories with all the associated technologies\n\n#### Parameters\n\nThe following parameters can be used to filter the data:\n\n- `category` (optional): A comma-separated string representing the category name(s).\n- `onlyname` (optional): No value required. If present, only the category names will be returned.\n\n#### Response\n\n```bash\ncurl --request GET \\\n  --url 'https://d{{HOST}}/v1/categories?category=Domain%20parking%2CCI'\n```\n\n```json\n[\n    {\n        \"description\": \"Systems that automate building, testing, and deploying code\",\n        \"technologies\": [\n            \"Jenkins\",\n            \"TeamCity\"\n        ],\n        \"origins\": {\n            \"mobile\": 22,\n            \"desktop\": 35\n        },\n        \"category\": \"CI\"\n    },\n    {\n        \"description\": \"Solutions that redirect domains to a different location or page\",\n        \"technologies\": [\n          \"Cloudflare\",\n          \"Arsys Domain Parking\"\n        ],\n        \"origins\": {\n            \"mobile\": 14,\n            \"desktop\": 8\n        },\n        \"category\": \"Domain parking\"\n    }\n]\n```\n\n```bash\ncurl --request GET \\\n  --url 'https://{{HOST}}/v1/categories?onlyname'\n```\n\n```json\n[\n    \"A/B Testing\",\n    \"Accessibility\",\n    \"Accounting\",\n    \"Advertising\",\n    \"Affiliate programs\",\n    \"Analytics\",\n  ...\n]\n\n```\n\n### `GET /cwv`\n\n#### Parameters\n\nThe following parameters can be used to filter the data:\n\n- `geo` (`required`): A string representing the geographic location.\n- `technology` (`required`): A string representing the technology name.\n- `rank` (`required`): An string representing the rank.\n- `start` (optional): A string representing the start date in the format `YYYY-MM-DD`.\n- `end` (optional): A string representing the end date in the format `YYYY-MM-DD`.\n\n#### Response\n\n```bash\ncurl --request GET \\\n  --url 'https://{{HOST}}/v1/cwv?start=2023-01-01\u0026end=2023-09-01\u0026geo=Uruguay\u0026technology=DomainFactory\u0026rank=ALL'\n\n```\n\n```json\n[\n    {\n        \"geo\": \"Uruguay\",\n        \"date\": \"2023-06-01\",\n        \"rank\": \"ALL\",\n        \"technology\": \"DomainFactory\",\n        \"vitals\": [\n            {\n                \"mobile\": {\n                    \"good_number\": 1,\n                    \"tested\": 4\n                },\n                \"desktop\": {\n                    \"good_number\": 0,\n                    \"tested\": 2\n                },\n                \"name\": \"overall\"\n            },\n      ...\n        ]\n    }\n]\n\n```\n\n### `GET /lighthouse`\n\n#### Parameters\n\nThe following parameters can be used to filter the data:\n\n- `technology` (`required`): A comma-separated string representing the technology name(s).\n- `geo` (`required`): A string representing the geographic location.\n- `rank` (`required`): An string representing the rank.\n- `start` (optional): A string representing the start date in the format `YYYY-MM-DD`.\n- `end` (optional): A string representing the end date in the format `YYYY-MM-DD`.\n\n#### Response\n\n```bash\ncurl --request GET \\\n  --url 'https://{{HOST}}/v1/lighthouse?start=2023-01-01\u0026end=2023-09-01\u0026geo=Maldives\u0026technology=Oracle%20HTTP%20Server%2C%20Google%20Optimize%2C%20Searchanise\u0026rank=ALL'\n```\n\nReturns a JSON object with the following schema:\n\n```json\n[\n    {\n        \"geo\": \"Maldives\",\n        \"date\": \"2023-06-01\",\n        \"rank\": \"ALL\",\n        \"technology\": \"Oracle HTTP Server\",\n        \"lighthouse\": [\n            {\n                \"mobile\": {\n                    \"median_score\": 0.945\n                },\n                \"desktop\": null,\n                \"name\": \"accessibility\"\n            },\n            {\n                \"mobile\": {\n                    \"median_score\": 0.915\n                },\n                \"desktop\": null,\n                \"name\": \"best_practices\"\n            },\n            ...\n        ]\n    }\n]\n```\n\n### `GET /page-weight`\n\n#### Parameters\n\nThe following parameters can be used to filter the data:\n\n- `geo` (`required`): A string representing the geographic location.\n- `technology` (`required`): A comma-separated string representing the technology name(s).\n- `rank` (`required`): An string representing the rank.\n- `start` (optional): A string representing the start date in the format `YYYY-MM-DD`.\n- `end` (optional): A string representing the end date in the format `YYYY-MM-DD`.\n\n#### Response\n\n```bash\ncurl --request GET \\\n  --url 'https://{{HOST}}/v1/page-weight?geo=ALL\u0026technology=WordPress\u0026rank=ALL'\n```\n\nReturns a JSON object with the following schema:\n\n```json\n[\n    {\n        \"client\": \"desktop\",\n        \"date\": \"2023-07-01\",\n        \"geo\": \"ALL\",\n        \"median_bytes_image\": \"1048110\",\n        \"technology\": \"WordPress\",\n        \"median_bytes_total\": \"2600099\",\n        \"median_bytes_js\": \"652651\",\n        \"rank\": \"ALL\"\n    }\n    ...\n]\n```\n\n### `GET /technologies`\n\n#### Parameters\n\nThe following parameters can be used to filter the data:\n\n- `technology` (optional): A comma-separated string representing the technology name(s) or `ALL`.\n- `category` (optional): A comma-separated string representing the category name(s).\n- `onlyname` (optional): No value required. If present, only the technology names will be returned.\n\n#### Response\n\n```bash\ncurl --request GET \\\n  --url 'https://{{HOST}}/v1/technologies?category=Live%20chat%2C%20blog\u0026technology=Smartsupp'\n```\n\nReturns a JSON object with the following schema:\n\n```json\n[\n  {\n    \"technology\": \"Smartsupp\",\n    \"category\": \"Live chat\",\n    \"description\": \"Smartsupp is a live chat tool that offers visitor recording feature.\",\n    \"icon\": \"Smartsupp.svg\",\n    \"origins\": {\n      \"mobile\": 24115,\n      \"desktop\": 20250\n    }\n  }\n]\n```\n\n```bash\ncurl --request GET \\\n  --url 'https://{{HOST}}/v1/technologies?onlyname'\n```\n\nReturns a JSON object with the following schema:\n\n```json\n[\n    \"1C-Bitrix\",\n    \"2B Advice\",\n    \"33Across\",\n    \"34SP.com\",\n    \"4-Tell\",\n    \"42stores\",\n    \"51.LA\",\n    \"5centsCDN\",\n    ...\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhttparchive%2Ftech-report-apis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhttparchive%2Ftech-report-apis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhttparchive%2Ftech-report-apis/lists"}