Paid News Search proxy via x402 pay-per-use (HTTP 402).
> Prerequisites: This skill requires x402-payment. Complete the setup steps before first use.
>
> Security: Documentation only — no executable code or credentials. Wallet/keys stay on your machine; never stored here.
| Role | Domain |
|---|---|
| ------ | -------- |
| API Provider | https://www.cpbox.io |
| Facilitator | https://www.cppay.finance |
GET /api/x402/news-search
POST /api/x402/news-search/post
PAYMENT-SIGNATURE) -> 402 Payment Required with requirements JSONPAYMENT-SIGNATUREPAYMENT-SIGNATURE -> Server settles and returns JSONWith @springmint/x402-payment or x402-sdk-go, payment is automatic.
curl -s "https://www.cpbox.io/api/x402/news-search?q=space+exploration" \
-H "Accept: application/json"
curl -s "https://www.cpbox.io/api/x402/news-search" \
-H "Accept: application/json" \
-G \
--data-urlencode "q=cybersecurity" \
--data-urlencode "country=US" \
--data-urlencode "freshness=pd" \
--data-urlencode "count=20"
curl -s "https://www.cpbox.io/api/x402/news-search" \
-H "Accept: application/json" \
-G \
--data-urlencode "q=climate summit" \
--data-urlencode "freshness=2026-01-01to2026-01-31"
npx @springmint/x402-payment \
--url https://www.cpbox.io/api/x402/news-search \
--method GET
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| -- | -- | -- | -- | -- |
q | string | Yes | - | Search query (1-400 chars, max 50 words) |
country | string | No | US | Search country (2-letter country code or ALL) |
search_lang | string | No | en | Language preference (2+ char language code) |
ui_lang | string | No | en-US | UI language (e.g., "en-US") |
count | int | No | 20 | Number of results (1-50) |
offset | int | No | 0 | Page offset (0-9) |
safesearch | string | No | strict | Adult content filter (off/moderate/strict) |
freshness | string | No | - | Time filter (pd/pw/pm/py or date range) |
spellcheck | bool | No | true | Auto-correct query |
extra_snippets | bool | No | - | Up to 5 additional excerpts per result |
goggles | string or array | No | - | Custom ranking filter (URL or inline; repeat param for multiple) |
operators | bool | No | true | Apply search operators |
include_fetch_metadata | bool | No | false | Include fetch timestamps in results |
| Value | Description |
|---|---|
| -- | -- |
pd | Past day (24 hours) - ideal for breaking news |
pw | Past week (7 days) |
pm | Past month (31 days) |
py | Past year (365 days) |
YYYY-MM-DDtoYYYY-MM-DD | Custom date range |
{
"type": "news",
"query": {
"original": "space exploration"
},
"results": [
{
"type": "news_result",
"title": "New Developments in Space Exploration",
"url": "https://news.example.com/space-exploration",
"description": "Recent missions have advanced our understanding of...",
"age": "2 hours ago",
"page_age": "2026-01-15T14:30:00",
"page_fetched": "2026-01-15T15:00:00Z",
"meta_url": {
"scheme": "https",
"netloc": "news.example.com",
"hostname": "news.example.com",
"favicon": "https://imgs.search.provider/favicon/news.example.com",
"path": "/space-exploration"
},
"thumbnail": {
"src": "https://imgs.search.provider/..."
}
}
]
}
| Field | Type | Description |
|---|---|---|
| -- | -- | -- |
type | string | Always "news" |
query.original | string | The original search query |
query.altered | string? | Spellcheck-corrected query (if changed) |
query.cleaned | string? | Cleaned/normalized query from spellchecker |
query.spellcheck_off | bool? | Whether spellcheck was disabled |
query.show_strict_warning | bool? | True if strict safesearch blocked results |
query.search_operators | object? | Applied search operators |
query.search_operators.applied | bool | Whether operators were applied |
query.search_operators.cleaned_query | string? | Query after operator processing |
query.search_operators.sites | list[str]? | Domains from site: operators |
results[].type | string | Always "news_result" |
results[].title | string | Article title |
results[].url | string | Source URL of the article |
results[].description | string? | Article description/summary |
results[].age | string? | Human-readable age (e.g. "2 hours ago") |
results[].page_age | string? | Publication date from source (ISO datetime) |
results[].page_fetched | string? | When page was last fetched (ISO datetime) |
results[].fetched_content_timestamp | int? | Fetch timestamp (only with include_fetch_metadata=true) |
results[].meta_url.scheme | string? | URL protocol scheme |
results[].meta_url.netloc | string? | Network location |
results[].meta_url.hostname | string? | Lowercased domain name |
results[].meta_url.favicon | string? | Favicon URL |
results[].meta_url.path | string? | URL path |
results[].thumbnail.src | string | Served thumbnail URL |
results[].thumbnail.original | string? | Original thumbnail URL |
results[].extra_snippets | list[str]? | Up to 5 additional excerpts per result |
Goggles let you re-rank news results — boost trusted outlets or suppress unwanted sources.
| Method | Example |
|---|---|
| -- | -- |
| Hosted | --data-urlencode "goggles=https:// |
| Inline | --data-urlencode 'goggles=$discard\n$site=example.com' |
> Hosted goggles should be hosted on a public URL and include ! name:, ! description:, ! author: headers. Inline rules need no registration.
Syntax: $boost=N / $downrank=N (1–10), $discard, $site=example.com. Combine with commas: $site=example.com,boost=3. Separate rules with \n (%0A).
Allow list: $discard\n$site=docs.python.org\n$site=developer.mozilla.org — Block list: $discard,site=pinterest.com\n$discard,site=quora.com
Resources: See your upstream provider's Goggles documentation.
Use search operators to refine results:
site:local-paper.com - Limit to specific news site"exact phrase" - Match exact phrase-exclude - Exclude termSet operators=false to disable operator parsing.
freshness=pd for the most recent articles on a topic.freshness=YYYY-MM-DDtoYYYY-MM-DD to find articles from specific time periods.country, search_lang, and ui_lang for cross-locale results.include_fetch_metadata=true for fetched_content_timestamp on each result.strictoffset (0-9) with countextra_snippets=true共 1 个版本