ニュースを検索

POST

/rest/v1/searchNews

curl --request POST \
  --url https://game.retrogather.com/rest/v1/searchNews \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "query": "example", "sourceType": "YOUTUBE", "sourceSite": "example", "publishedFrom": "2026-04-15", "publishedTo": "2026-04-15", "page": 1, "limit": 1 }'

News / ニュース: search retained RGG news (max 500, short TTL cache). Not a live web search. Space-separated terms must all match (title, or summary for non-YouTube). summary is cut at 200 characters. games:read.

Plans: FREE / LIGHT / PREMIUM. Scopes: games:read.

Authorizations

• apiKey

Request Body

Media typeapplication/json

object

query

string

sourceType

YOUTUBE (videos) or WEB (articles).

string

Allowed values: YOUTUBE WEB

sourceSite

Exact sourceSite value as returned in results (e.g. a site or channel name).

string

publishedFrom

YYYY-MM-DD, inclusive.

string format: date

publishedTo

YYYY-MM-DD, inclusive.

string format: date

page

integer

>= 1

limit

integer

>= 1 <= 50

Responses

200

Tool result JSON (no MCP envelope). Delete previews also return 200 with confirmToken.

Media typeapplication/json

Any of:

object

object

items

required

Array<object>

object

newsId

required

string

title

required

string

url

required

string

summary

string

sourceType

string

sourceSite

string

publishedAt

string

key

additional properties

any

page

required

integer

returnedCount

required

integer

totalCount

required

integer

hasMore

required

boolean

effectiveLimit

integer

limitReduced

boolean

limitReason

string

cacheUpdatedAt

string

retainedCount

integer

oldestPublishedAt

string

newestPublishedAt

string

regenerated

boolean

note

string

key

additional properties

any

object

object

code

required

string

Allowed values: plan_required not_found invalid_input unavailable already_exists revision_conflict insufficient_scope

message

string

upgradeUrl

string

field

string

allowedValues

Array<string>

scope

string

additionalScopesRequired

Array<string>

playId

string

saved

boolean

physicalId

string

physicalIds

Array<string>

createdPhysicalIds

Array<string>

deletedId

string

status

string

Allowed values: PLANNED PLAYING PAUSED COMPLETED DROPPED

items

Array<object>

object

gameId

required

integer

status

required

string

Allowed values: added already_in_library not_found

fromWishlist

boolean

key

additional properties

any

limit

object

max

required

integer

current

required

integer

requested

required

integer

key

additional properties

any

key

additional properties

any

Example

{
  "code": "plan_required",
  "status": "PLANNED",
  "items": [
    {
      "status": "added"
    }
  ]
}

400

Invalid_input (arguments, broken JSON body)

Media typeapplication/json

Entry errors (auth, routing, quota) use error; tool errors use code and message. Check retryable when present.

object

error

string

code

string

message

string

retryable

boolean

retryAfterSec

integer

requestId

string

resetAt

string

remaining

integer

scopes

Array<string>

upgradeUrl

string

key

additional properties

any

Example^generated

{
  "error": "example",
  "code": "example",
  "message": "example",
  "retryable": true,
  "retryAfterSec": 1,
  "requestId": "example",
  "resetAt": "example",
  "remaining": 1,
  "scopes": [
    "example"
  ],
  "upgradeUrl": "example"
}

401

Missing or invalid API key

Media typeapplication/json

Entry errors (auth, routing, quota) use error; tool errors use code and message. Check retryable when present.

object

error

string

code

string

message

string

retryable

boolean

retryAfterSec

integer

requestId

string

resetAt

string

remaining

integer

scopes

Array<string>

upgradeUrl

string

key

additional properties

any

Example^generated

{
  "error": "example",
  "code": "example",
  "message": "example",
  "retryable": true,
  "retryAfterSec": 1,
  "requestId": "example",
  "resetAt": "example",
  "remaining": 1,
  "scopes": [
    "example"
  ],
  "upgradeUrl": "example"
}

403

Insufficient_scope, plan_required, or access_suspended

Media typeapplication/json

Entry errors (auth, routing, quota) use error; tool errors use code and message. Check retryable when present.

object

error

string

code

string

message

string

retryable

boolean

retryAfterSec

integer

requestId

string

resetAt

string

remaining

integer

scopes

Array<string>

upgradeUrl

string

key

additional properties

any

Example^generated

{
  "error": "example",
  "code": "example",
  "message": "example",
  "retryable": true,
  "retryAfterSec": 1,
  "requestId": "example",
  "resetAt": "example",
  "remaining": 1,
  "scopes": [
    "example"
  ],
  "upgradeUrl": "example"
}

404

Target or tool not found

Media typeapplication/json

Entry errors (auth, routing, quota) use error; tool errors use code and message. Check retryable when present.

object

error

string

code

string

message

string

retryable

boolean

retryAfterSec

integer

requestId

string

resetAt

string

remaining

integer

scopes

Array<string>

upgradeUrl

string

key

additional properties

any

Example^generated

{
  "error": "example",
  "code": "example",
  "message": "example",
  "retryable": true,
  "retryAfterSec": 1,
  "requestId": "example",
  "resetAt": "example",
  "remaining": 1,
  "scopes": [
    "example"
  ],
  "upgradeUrl": "example"
}

429

Burst or daily quota exceeded. See resetAt.

Media typeapplication/json

Entry errors (auth, routing, quota) use error; tool errors use code and message. Check retryable when present.

object

error

string

code

string

message

string

retryable

boolean

retryAfterSec

integer

requestId

string

resetAt

string

remaining

integer

scopes

Array<string>

upgradeUrl

string

key

additional properties

any

Example^generated

{
  "error": "example",
  "code": "example",
  "message": "example",
  "retryable": true,
  "retryAfterSec": 1,
  "requestId": "example",
  "resetAt": "example",
  "remaining": 1,
  "scopes": [
    "example"
  ],
  "upgradeUrl": "example"
}

Headers

Retry-After

integer

Seconds

500

Unexpected server failure. Retrying the same call will not help.

Media typeapplication/json

Entry errors (auth, routing, quota) use error; tool errors use code and message. Check retryable when present.

object

error

string

code

string

message

string

retryable

boolean

retryAfterSec

integer

requestId

string

resetAt

string

remaining

integer

scopes

Array<string>

upgradeUrl

string

key

additional properties

any

Example^generated

{
  "error": "example",
  "code": "example",
  "message": "example",
  "retryable": true,
  "retryAfterSec": 1,
  "requestId": "example",
  "resetAt": "example",
  "remaining": 1,
  "scopes": [
    "example"
  ],
  "upgradeUrl": "example"
}

503

Temporary failure or maintenance. Retry after Retry-After.

Media typeapplication/json

Entry errors (auth, routing, quota) use error; tool errors use code and message. Check retryable when present.

object

error

string

code

string

message

string

retryable

boolean

retryAfterSec

integer

requestId

string

resetAt

string

remaining

integer

scopes

Array<string>

upgradeUrl

string

key

additional properties

any

Example^generated

{
  "error": "example",
  "code": "example",
  "message": "example",
  "retryable": true,
  "retryAfterSec": 1,
  "requestId": "example",
  "resetAt": "example",
  "remaining": 1,
  "scopes": [
    "example"
  ],
  "upgradeUrl": "example"
}

Headers

Retry-After

integer

Seconds