Docs menu

Wattpad API endpoint

Search Wattpad authors by name API

Searches Wattpad's authors by username or name and returns one page: username, display name, bio, avatar, verified flag, published story count and follower count. limit is 1 to 100 (default 20) and offset pages the results. Authors with a private profile or who have opted out of crawling are left out, so a page can hold fewer authors than limit; advance with next_offset.

GETapiKey1 credit/requestWattpadwattpad.searchUsersResponseDoc/wattpad/search-users

Endpoint facts

Method: GET
API path: /wattpad/search-users
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Wattpad
Response schema: #/definitions/wattpad.searchUsersResponseDoc

Wattpad Stories API Try Search Wattpad authors by name API in Playground Wattpad API documentation

How this endpoint behaves

Parameters:

query (required): the name to search for, up to 200 characters.
limit: 1 to 100; defaults to 20.
offset: zero-based result offset, from 0 to 9999; defaults to 0.

Notable response behavior:

Authors with a private profile, or who have turned off Wattpad's "allow crawlers" setting, are left out, so a page can hold fewer authors than limit. Advance with next_offset, which is absent when the page was short.
Email addresses that authors paste into their bios are replaced with [email removed].
Personal attributes such as gender and locale are never returned.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "users": [
      {
        "username": "example_author_1",
        "avatar": "https://img.wattpad.com/useravatar/example_author_1.128.1.jpg",
        "verified": false,
        "stories_published": 2,
        "followers": 1,
        "description": "",
        "name": ""
      },
      {
        "username": "example_author_2",
        "avatar": "https://img.wattpad.com/useravatar/example_author_2.128.1.jpg",
        "verified": false,
        "stories_published": 0,
        "followers": 0,
        "description": "",
        "name": ""
      }
    ],
    "limit": 3,
    "offset": 0,
    "next_offset": 3
  }
}

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Author name to search for, up to 200 characters	notjust
limit	integer	No	20	Page size, 1 to 100; defaults to 20	5
offset	integer	No	0	Zero-based result offset, below 10000; defaults to 0	0
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wattpad/search-users?query=notjust&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "users": [
      {
        "username": "example_author_1",
        "avatar": "https://img.wattpad.com/useravatar/example_author_1.128.1.jpg",
        "verified": false,
        "stories_published": 2,
        "followers": 1,
        "description": "",
        "name": ""
      },
      {
        "username": "example_author_2",
        "avatar": "https://img.wattpad.com/useravatar/example_author_2.128.1.jpg",
        "verified": false,
        "stories_published": 0,
        "followers": 0,
        "description": "",
        "name": ""
      }
    ],
    "limit": 3,
    "offset": 0,
    "next_offset": 3
  }
}

Request schema

No body schema

Response schema

#/definitions/wattpad.searchUsersResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	wattpad.SearchUsersResponse	No
data.limit	integer	No
data.next_offset	integer	No		NextOffset is the offset of the next page; it is absent when this page held fewer users than were asked for.
data.offset	integer	No
data.users	array	No
data.users[].avatar	string	No
data.users[].description	string	No
data.users[].followers	integer	No
data.users[].name	string	No
data.users[].stories_published	integer	No
data.users[].username	string	No
data.users[].verified	boolean	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/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/wattpad/search-users?query=notjust&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Wattpad endpoint docs Wattpad Stories API List Wattpad story categories API documentation List Wattpad story languages API documentation Wattpad Chapter Comments API documentation Get a Wattpad chapter API documentation Search and browse Wattpad stories API documentation List a Wattpad story's chapters API documentation

Open in Playground Back to group

Docs menu

Wattpad API endpoint

Search Wattpad authors by name API

GETapiKey1 credit/requestWattpadwattpad.searchUsersResponseDoc/wattpad/search-users

Endpoint facts

Method: GET
API path: /wattpad/search-users
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Wattpad
Response schema: #/definitions/wattpad.searchUsersResponseDoc

Wattpad Stories API Try Search Wattpad authors by name API in Playground Wattpad API documentation

How this endpoint behaves

Parameters:

query (required): the name to search for, up to 200 characters.
limit: 1 to 100; defaults to 20.
offset: zero-based result offset, from 0 to 9999; defaults to 0.

Notable response behavior:

Authors with a private profile, or who have turned off Wattpad's "allow crawlers" setting, are left out, so a page can hold fewer authors than limit. Advance with next_offset, which is absent when the page was short.
Email addresses that authors paste into their bios are replaced with [email removed].
Personal attributes such as gender and locale are never returned.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "users": [
      {
        "username": "example_author_1",
        "avatar": "https://img.wattpad.com/useravatar/example_author_1.128.1.jpg",
        "verified": false,
        "stories_published": 2,
        "followers": 1,
        "description": "",
        "name": ""
      },
      {
        "username": "example_author_2",
        "avatar": "https://img.wattpad.com/useravatar/example_author_2.128.1.jpg",
        "verified": false,
        "stories_published": 0,
        "followers": 0,
        "description": "",
        "name": ""
      }
    ],
    "limit": 3,
    "offset": 0,
    "next_offset": 3
  }
}

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Author name to search for, up to 200 characters	notjust
limit	integer	No	20	Page size, 1 to 100; defaults to 20	5
offset	integer	No	0	Zero-based result offset, below 10000; defaults to 0	0
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wattpad/search-users?query=notjust&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "users": [
      {
        "username": "example_author_1",
        "avatar": "https://img.wattpad.com/useravatar/example_author_1.128.1.jpg",
        "verified": false,
        "stories_published": 2,
        "followers": 1,
        "description": "",
        "name": ""
      },
      {
        "username": "example_author_2",
        "avatar": "https://img.wattpad.com/useravatar/example_author_2.128.1.jpg",
        "verified": false,
        "stories_published": 0,
        "followers": 0,
        "description": "",
        "name": ""
      }
    ],
    "limit": 3,
    "offset": 0,
    "next_offset": 3
  }
}

Request schema

No body schema

Response schema

#/definitions/wattpad.searchUsersResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	wattpad.SearchUsersResponse	No
data.limit	integer	No
data.next_offset	integer	No		NextOffset is the offset of the next page; it is absent when this page held fewer users than were asked for.
data.offset	integer	No
data.users	array	No
data.users[].avatar	string	No
data.users[].description	string	No
data.users[].followers	integer	No
data.users[].name	string	No
data.users[].stories_published	integer	No
data.users[].username	string	No
data.users[].verified	boolean	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/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/wattpad/search-users?query=notjust&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Search Wattpad authors by name API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Search Wattpad authors by name API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related