Search a source

GET

/api/v1/me/extensions/{extensionId}/search

curl --request GET \
  --url 'http://localhost:8080/api/v1/me/extensions/example/search?page=1' \
  --header 'Authorization: Bearer <token>'

One page of the source’s series matching q. Without q, the series the source shows first, such as its popular ones. Only series in the user’s content ratings are listed: the source is asked for those, and items it rates otherwise are dropped, so a page may hold fewer items than the source’s usual page while hasMore is true. Series the source doesn’t rate are kept. After changing the ratings, a client reloads past its cached answers.

Authorizations

• session
• basic

Parameters

Path Parameters

extensionId

required

string

The extension’s reverse-DNS id.

Query Parameters

q

string

<= 200 characters

page

integer

default: 1 >= 1

Counts from 1.

Responses

200

Matching series.

Media typeapplication/json

object

items

required

Array<object>

object

id

required

The source’s own series id.

string

title

required

string

coverUrl

required

One of:

string

A path on this server, relative to its base URL, that serves the image.

string

null

null

contentRating

required

One of:

string

How explicit a series is, mildest first, on the scale MangaDex uses. suggestive is fan service and mild sexual themes, erotica nudity or sexual content short of explicit, and pornographic explicit.

string

Allowed values: safe suggestive erotica pornographic

null

null

hasMore

required

boolean

Example

{
  "items": [
    {
      "coverUrl": "/api/v1/me/extensions/org.example.comics/image?ref=eyJ1cmwiOi",
      "contentRating": "safe"
    }
  ]
}

400

The request was malformed.

Media typeapplication/json

object

code

required

string

Allowed values: bad_request unauthorized forbidden not_found unavailable scan_in_progress content_changed already_set_up name_taken last_admin progress_conflict too_many_attempts not_linked identity_taken last_sign_in provider_unavailable too_many_sign_ins repository_exists repository_not_allowed repository_unreadable repository_needs_token repository_needs_password repository_needs_credentials repository_credentials_refused extension_invalid source_failed source_unavailable source_check_failed internal

message

required

Explains the problem to a developer.

string

Example

{
  "code": "bad_request"
}

401

The request has no valid session token.

Media typeapplication/json

object

code

required

string

Allowed values: bad_request unauthorized forbidden not_found unavailable scan_in_progress content_changed already_set_up name_taken last_admin progress_conflict too_many_attempts not_linked identity_taken last_sign_in provider_unavailable too_many_sign_ins repository_exists repository_not_allowed repository_unreadable repository_needs_token repository_needs_password repository_needs_credentials repository_credentials_refused extension_invalid source_failed source_unavailable source_check_failed internal

message

required

Explains the problem to a developer.

string

Example

{
  "code": "bad_request"
}

403

The signed-in user may not do this. demo_account when the user is a shared demo account, named in CHEK_DEMO_USERS, which can’t change its password, sessions, sign-in providers, extensions or annotations.

Media typeapplication/json

object

code

required

string

Allowed values: bad_request unauthorized forbidden not_found unavailable scan_in_progress content_changed already_set_up name_taken last_admin progress_conflict too_many_attempts not_linked identity_taken last_sign_in provider_unavailable too_many_sign_ins repository_exists repository_not_allowed repository_unreadable repository_needs_token repository_needs_password repository_needs_credentials repository_credentials_refused extension_invalid source_failed source_unavailable source_check_failed internal

message

required

Explains the problem to a developer.

string

Example

{
  "code": "bad_request"
}

404

The resource does not exist.

Media typeapplication/json

object

code

required

string

Allowed values: bad_request unauthorized forbidden not_found unavailable scan_in_progress content_changed already_set_up name_taken last_admin progress_conflict too_many_attempts not_linked identity_taken last_sign_in provider_unavailable too_many_sign_ins repository_exists repository_not_allowed repository_unreadable repository_needs_token repository_needs_password repository_needs_credentials repository_credentials_refused extension_invalid source_failed source_unavailable source_check_failed internal

message

required

Explains the problem to a developer.

string

Example

{
  "code": "bad_request"
}

500

The server failed; details are in its log.

Media typeapplication/json

object

code

required

string

Allowed values: bad_request unauthorized forbidden not_found unavailable scan_in_progress content_changed already_set_up name_taken last_admin progress_conflict too_many_attempts not_linked identity_taken last_sign_in provider_unavailable too_many_sign_ins repository_exists repository_not_allowed repository_unreadable repository_needs_token repository_needs_password repository_needs_credentials repository_credentials_refused extension_invalid source_failed source_unavailable source_check_failed internal

message

required

Explains the problem to a developer.

string

Example

{
  "code": "bad_request"
}

502

The extension reported an error, went over a limit, or the image couldn’t be fetched.

Media typeapplication/json

object

code

required

string

Allowed values: bad_request unauthorized forbidden not_found unavailable scan_in_progress content_changed already_set_up name_taken last_admin progress_conflict too_many_attempts not_linked identity_taken last_sign_in provider_unavailable too_many_sign_ins repository_exists repository_not_allowed repository_unreadable repository_needs_token repository_needs_password repository_needs_credentials repository_credentials_refused extension_invalid source_failed source_unavailable source_check_failed internal

message

required

Explains the problem to a developer.

string

Example

{
  "code": "bad_request"
}