Docs menu
Raw Story API endpoint
Raw Story author profile API
Returns a Raw Story author's profile, looked up by `slug` (for example `bennitokelty`) or canonical `url`; exactly one is required. The response has the name, `bio`, avatar, social links and the 15 most recent stories, each with title, URL and a `YYYY-MM-DD` date. Older stories are not reachable, and an unknown author returns not-found.
GETapiKey2 credits/requestRaw Storypublicnews.rawstoryAuthorResponseDoc
Raw Story/rawstory/authorEndpoint facts
- Method
- GET
- API path
- /rawstory/author
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- Raw Story
- Response schema
- #/definitions/publicnews.rawstoryAuthorResponseDoc
How this endpoint behaves
Query parameters:
slug(optional): an author slug, e.g.bennitokelty, the last segment of the author link (/u/<slug>) in a story's byline.url(optional): a canonicalhttps://www.rawstory.com/u/<slug>URL, as an alternative toslug.
Exactly one of slug/url is required. The response covers the first page of the author's profile (the 15 most recent stories; older stories are loaded by a script-driven button on the site and are not reachable); each story has title, url, and published_at (a YYYY-MM-DD date, because the profile lists the day but not the time). bio, image_url and social_links are omitted when the author has none. An unknown author returns a not-found error.
Example response (truncated):
{"code":200,"data":{"name":"Bennito L. Kelty","slug":"bennitokelty","url":"https://www.rawstory.com/u/bennitokelty","bio":"Bennito L. Kelty is an award-winning journalist at Raw Story. He covered the U.S.-Mexico borderlands in Arizona and later homelessness, immigration and politics for Denver Westword.","image_url":"https://www.rawstory.com/media-library/eyJhbGci.../image.jpg?width=210","articles":[{"title":"Expert sounds the alarm as Trump's press ban points to historic danger: 'An outrage'","url":"https://www.rawstory.com/trump-media-ban-2677933730","published_at":"2026-09-25"}]}}
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug | string | No | Author slug, e.g. bennitokelty | bennitokelty | |
| url | string | No | Canonical rawstory.com/u/<slug> URL; alternative to slug | https://www.rawstory.com/u/bennitokelty | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/rawstory/author" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"name": "Bennito L. Kelty",
"slug": "bennitokelty",
"url": "https://www.rawstory.com/u/bennitokelty",
"bio": "Bennito L. Kelty is an award-winning journalist at Raw Story. He covered the U.S.-Mexico borderlands in Arizona and later homelessness, immigration and politics for Denver Westword.",
"image_url": "https://www.rawstory.com/media-library/eyJhbGci.../image.jpg?width=210",
"articles": [
{
"title": "Expert sounds the alarm as Trump's press ban points to historic danger: 'An outrage'",
"url": "https://www.rawstory.com/trump-media-ban-2677933730",
"published_at": "2026-09-25"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.rawstoryAuthorResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | rawstory.AuthorResponse | No | ||||
| data.articles | array | No | ||||
| data.articles[].published_at | string | No | PublishedAt is the story's publication date (YYYY-MM-DD); the author listing carries the date but not the time of day. | |||
| data.articles[].title | string | No | ||||
| data.articles[].url | string | No | ||||
| data.bio | string | No | ||||
| data.image_url | string | No | ||||
| data.name | string | No | ||||
| data.slug | string | No | ||||
| data.social_links | array | No | ||||
| data.url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/rawstory/author" \
-H "x-api-key: $CRAWLORA_API_KEY"