Websites by Theme API
Find websites using a specific theme. Narrow your results by language, domain, keywords, and Lighthouse scores.
Endpoint
POST
https://api.stackcrawler.com/v1/websites-by-themeAuthentication
Send your API key as a Bearer token in the Authorization header.
Content-Type: application/json
Authorization: Bearer YOUR_API_KEYRequests count toward the API allowance for your current plan. Every account includes 25 free API requests.
Request body
| Name | Required | Description |
|---|---|---|
theme | Required | Theme slug, such as dawn. Browse the theme directory to find available slugs. |
languages | Optional | Comma-separated language codes, such as en,de. |
tlds | Optional | Comma-separated top-level domains, such as com,org,net. |
keywords | Optional | Comma-separated keywords matched against the URL, title, and meta description. |
minPerformanceScore | Optional | Minimum Lighthouse performance score from 0 to 100. |
maxPerformanceScore | Optional | Maximum Lighthouse performance score from 0 to 100. |
minAccessibilityScore | Optional | Minimum Lighthouse accessibility score from 0 to 100. |
maxAccessibilityScore | Optional | Maximum Lighthouse accessibility score from 0 to 100. |
minBestPracticesScore | Optional | Minimum Lighthouse best-practices score from 0 to 100. |
maxBestPracticesScore | Optional | Maximum Lighthouse best-practices score from 0 to 100. |
minSeoScore | Optional | Minimum Lighthouse SEO score from 0 to 100. |
maxSeoScore | Optional | Maximum Lighthouse SEO score from 0 to 100. |
Pagination
| Name | Required | Description |
|---|---|---|
page | No | Page number. Defaults to 1. |
limit | No | Results per page. Defaults to 10 and is capped at 100. |
Response
The response contains the matched theme, a websites array, the total number of matching websites in totalWebsites, and the available page count in maxPages. Website records include theme version, public website details, Lighthouse scores, contact and social fields when available, and detected technologies.
Example request
curl --location 'https://api.stackcrawler.com/v1/websites-by-theme?page=1&limit=10' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [YOUR_API_KEY_HERE]' \
--data '{
"theme": "dawn",
"languages": "en",
"tlds": "com,org"
}'Example response
{
"theme": {
"name": "Dawn",
"slug": "dawn",
"platform": "Shopify"
},
"websites": [
{
"url": "https://example.com",
"language": "en",
"title": "Example Store",
"metaDescription": "An example Shopify store.",
"themeVersion": "15.2.0",
"pagespeedPerformanceScore": 92,
"pagespeedAccessibilityScore": 96,
"pagespeedBestPracticesScore": 100,
"pagespeedSEOScore": 100,
"technologies": [
{ "name": "Shopify", "slug": "shopify", "url": "https://shopify.com" }
]
}
],
"totalWebsites": 1,
"maxPages": 1
}Error responses
| Status | Meaning |
|---|---|
| 400 | The request or a filter value is invalid. |
| 401 | The API key is missing or invalid. |
| 404 | The requested theme does not exist. |
| 429 | The rate or plan request limit was reached. |
| 500 | An internal error occurred. |