README.md

tech-report-apis

APIs for the HTTP Archive Technology Report

API

Endpoints

GET /adoption

Parameters

The following parameters can be used to filter the data:

• geo (required): A string representing the geographic location.
• technology (required): A comma-separated string representing the technology name(s).
• rank (required): An string representing the rank.
• start (optional): A string representing the start date in the format YYYY-MM-DD.
• end (optional): A string representing the end date in the format YYYY-MM-DD.

Response

curl --request GET \
  --url 'https://{{HOST}}/v1/adoption?start=2023-01-01&end=2023-09-01&geo=Mexico&technology=GoCache&rank=ALL'

Returns a JSON object with the following schema:

[
	{
		"technology": "GoCache",
		"geo": "Mexico",
		"date": "2023-06-01",
		"rank": "ALL",
		"adoption": {
			"mobile": 19,
			"desktop": 11
		}
	},
  ...
]

GET /categories

This endpoint can return a full list of categories names or a categories with all the associated technologies

Parameters

The following parameters can be used to filter the data:

• category (required): A comma-separated string representing the category name(s).
• onlyname (optional): A string 'true' or 'false'.

Response

curl --request GET \
  --url 'https://d{{HOST}}/v1/categories?category=Domain%20parking%2CCI'

[
	{
		"technologies": [
			"Arsys Domain Parking"
		],
		"origins": 11,
		"category": "Domain parking"
	},
	{
		"technologies": [
			"Jenkins",
			"TeamCity"
		],
		"origins": 20,
		"category": "CI"
	}
]

curl --request GET \
  --url 'https://{{HOST}}/v1/categories?onlyname=true'

[
	"Blogs",
	"LMS",
	"CI",
	"Cross border ecommerce",
	"Cart abandonment",
	"Domain parking",
  ...
]

GET /cwv

Parameters

The following parameters can be used to filter the data:

• geo (required): A string representing the geographic location.
• technology (required): A string representing the technology name.
• rank (required): An string representing the rank.
• start (optional): A string representing the start date in the format YYYY-MM-DD.
• end (optional): A string representing the end date in the format YYYY-MM-DD.

Response

curl --request GET \
  --url 'https://{{HOST}}/v1/cwv?start=2023-01-01&end=2023-09-01&geo=Uruguay&technology=DomainFactory&rank=ALL'

[
	{
		"geo": "Uruguay",
		"date": "2023-06-01",
    "rank": "ALL",
		"technology": "DomainFactory",
		"vitals": [
			{
				"mobile": {
					"good_number": 1,
					"tested": 4
				},
				"desktop": {
					"good_number": 0,
					"tested": 2
				},
				"name": "overall"
			},
      ...
		]
	}
]

GET /lighthouse

Parameters

The following parameters can be used to filter the data:

• technology (required): A comma-separated string representing the technology name(s).
• geo (required): A string representing the geographic location.
• rank (required): An string representing the rank.
• start (optional): A string representing the start date in the format YYYY-MM-DD.
• end (optional): A string representing the end date in the format YYYY-MM-DD.

Response

curl --request GET \
  --url 'https://{{HOST}}/v1/lighthouse?start=2023-01-01&end=2023-09-01&geo=Maldives&technology=Oracle%20HTTP%20Server%2C%20Google%20Optimize%2C%20Searchanise&rank=ALL'

Returns a JSON object with the following schema:

[
	{
		"geo": "Maldives",
		"date": "2023-06-01",
		"rank": "ALL",
		"technology": "Oracle HTTP Server",
		"lighthouse": [
			{
				"mobile": {
					"median_score": 0.945
				},
				"desktop": null,
				"name": "accessibility"
			},
			{
				"mobile": {
					"median_score": 0.915
				},
				"desktop": null,
				"name": "best_practices"
			},
			...
		]
	}
]

GET /page-weight

Parameters

The following parameters can be used to filter the data:

• geo (required): A string representing the geographic location.
• technology (required): A comma-separated string representing the technology name(s).
• rank (required): An string representing the rank.
• start (optional): A string representing the start date in the format YYYY-MM-DD.
• end (optional): A string representing the end date in the format YYYY-MM-DD.

Response

curl --request GET \
  --url 'https://{{HOST}}/v1/page-weight?geo=ALL&technology=WordPress&rank=ALL'

Returns a JSON object with the following schema:

[
	{
		"client": "desktop",
		"date": "2023-07-01",
		"geo": "ALL",
		"median_bytes_image": "1048110",
		"technology": "WordPress",
		"median_bytes_total": "2600099",
		"median_bytes_js": "652651",
		"rank": "ALL"
	}
	...
]

GET /technologies

Parameters

The following parameters can be used to filter the data:

• technology (required): A comma-separated string representing the technology name(s).
• start (optional): A string representing the start date in the format YYYY-MM-DD.
• end (optional): A string representing the end date in the format YYYY-MM-DD.
• geo (optional): A string representing the geographic location.
• rank (optional): An string representing the rank.
• category (optional): A comma-separated string representing the category name(s).

Response

curl --request GET \
  --url 'https://{{HOST}}/v1/technologies?start=2022-02-01&end=2022-04-01&category=Live%20chat%2C%20blog&technology=Smartsupp&client=mobile'

Returns a JSON object with the following schema:

[
	{
		"client": "mobile",
		"similar_technologies": null,
		"date": "2022-02-01",
		"description": "Smartsupp is a live chat tool that offers visitor recording feature.",
		"technology": "Smartsupp",
		"category": "Live chat",
		"origins": 16840
	},
  ...
]