Tom's Guide API endpoint
Returns a Tom's Guide author's name, job title, biography, social links and one page of recent articles. Give exactly one of `slug` or `url`; `page` is 1-based, defaults to 1 and overrides any page in `url`. The response also has `page` and `has_next_page`.
/tomsguide/authorQuery parameters:
slug (optional): an author slug, e.g. tom-pritchard.url (optional): a canonical https://www.tomsguide.com/author/<slug> URL, optionally with a /page/<n> path segment, as an alternative to slug. A URL that carries Tom's Guide's own /page/<n> pagination segment sets the page from that segment.page (optional): 1-based page number of the author's article list; overrides any page number embedded in url. Defaults to 1.Exactly one of slug/url is required. has_next_page reports whether Tom's Guide's own pagination link indicates a further page exists.
Example response (truncated):
{"code":200,"data":{"name":"Tom Pritchard","slug":"tom-pritchard","url":"https://www.tomsguide.com/author/tom-pritchard","job_title":"UK Phones Editor","biography":["Tom is the Tom's Guide's UK Phones Editor, tackling the latest smartphone news."],"social_links":[{"platform":"email","url":"mailto:[email protected]"}],"page":1,"has_next_page":true,"articles":[{"title":"Example headline","url":"https://www.tomsguide.com/phones/iphones/example-article-slug"}]}}
| Field | Filled in, of 25 checked | Values in the sample |
|---|---|---|
| title | 25 | median 97 characters |
| url | 25 | tomsguide.com |
| image_url | 25 | cdn.mos.cms.futurecdn.net |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug | string | No | Author slug, e.g. tom-pritchard | tom-pritchard | |
| url | string | No | Canonical tomsguide.com/author/<slug> URL, optionally with a /page/<n> segment; alternative to slug | https://www.tomsguide.com/author/tom-pritchard | |
| page | integer | No | 1-based page number; overrides any page number in url | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/tomsguide/author?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"name": "Tom Pritchard",
"slug": "tom-pritchard",
"url": "https://www.tomsguide.com/author/tom-pritchard",
"job_title": "UK Phones Editor",
"biography": [
"Tom is the Tom's Guide's UK Phones Editor, tackling the latest smartphone news."
],
"social_links": [
{
"platform": "email",
"url": "mailto:[email protected]"
}
],
"page": 1,
"has_next_page": true,
"articles": [
{
"title": "Example headline",
"url": "https://www.tomsguide.com/phones/iphones/example-article-slug"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.tomsguideAuthorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | tomsguide.AuthorResponse | No | ||||
| data.articles | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under Tom's Guide top stories API. | |||
| data.biography | array | No | ||||
| data.has_next_page | boolean | No | ||||
| data.job_title | string | No | ||||
| data.name | string | No | ||||
| data.page | integer | No | ||||
| data.slug | string | No | ||||
| data.social_links | array | No | ||||
| data.social_links[].platform | string | No | ||||
| data.social_links[].url | string | No | ||||
| data.url | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/tomsguide/author?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"