WeChat Official Accounts Article Search API (V1)

GET

API health status

Healthy Available Limited Mostly unavailable No data

Loading health status...

Searches WeChat Official Account articles through the WeChat web search flow. Version 1 supports publish time filtering, sort type, offset, and cookies_buffer pagination for retrieving fresh web-side article results.

Parameters

Name	In	Type	Required	Default	Description
token	query	string	Yes	-	Access token for this API service.
keyword	query	string	Yes	-	Search keyword for WeChat Official Account articles.
publishTimeType	query	string	No	ALL	Publish time filter for WeChat Official Account article web search. Available Values: - ALL: All time - ONE_DAY: Last day - SEVEN_DAYS: Last seven days - HALF_YEAR: Last half year
sortType	query	string	No	COMPREHENSIVE	Sort order for WeChat Official Account article web search results. Available Values: - COMPREHENSIVE: Comprehensive sort - LATEST: Latest first - HOT: Hot first
currentPage	query	integer	No	1	Current page number starting from 1 for WeChat web search pagination.
offset	query	integer	No	0	Search result offset returned by the previous response. Use 0 for the first page.
cookies_buffer	query	string	No	``	Cookie pagination state returned by the previous WeChat web search response. Leave it empty for the first page.

Code Samples

💡 Environment Note

Use https://api.justoneapi.com by default. Mainland China users can use http://47.117.133.51:30015 instead.

🐚 cURL

curl -X GET "https://api.justoneapi.com/api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE"

🤖 AI Prompt

I want to use the "Article Search (V1)" API from Just One API.
Base URL: use https://api.justoneapi.com by default. Mainland China users can use http://47.117.133.51:30015 instead.
API Path: /api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE
API Endpoint: BASE_URL + /api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/wechat-official-accounts/article-search-v1-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- keyword (query): Search keyword for WeChat Official Account articles. (Required)
- publishTimeType (query): Publish time filter for WeChat Official Account article web search.

Available Values:
- `ALL`: All time
- `ONE_DAY`: Last day
- `SEVEN_DAYS`: Last seven days
- `HALF_YEAR`: Last half year
- sortType (query): Sort order for WeChat Official Account article web search results.

Available Values:
- `COMPREHENSIVE`: Comprehensive sort
- `LATEST`: Latest first
- `HOT`: Hot first
- currentPage (query): Current page number starting from 1 for WeChat web search pagination.
- offset (query): Search result offset returned by the previous response. Use 0 for the first page.
- cookies_buffer (query): Cookie pagination state returned by the previous WeChat web search response. Leave it empty for the first page.

Return format: JSON

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance

Please help me write a script in my preferred programming language to call this API and handle the response.

🐍 Python

import requests

BASE_URL = "https://api.justoneapi.com"  # Mainland China: "http://47.117.133.51:30015"

url = BASE_URL + "/api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE"
response = requests.get(url)
print(response.json())

🌐 JavaScript

const BASE_URL = "https://api.justoneapi.com"; // Mainland China: "http://47.117.133.51:30015"
const url = BASE_URL + "/api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE";

const response = await fetch(url, {
  method: "GET"
});
const data = await response.json();
console.log(data);

☕ Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // Mainland China: "http://47.117.133.51:30015"
        final String url = BASE_URL + "/api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

🐹 Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

const BASE_URL = "https://api.justoneapi.com" // Mainland China: "http://47.117.133.51:30015"

func main() {
	client := &http.Client{}
	url := BASE_URL + "/api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

🐘 PHP

<?php
$BASE_URL = "https://api.justoneapi.com"; // Mainland China: "http://47.117.133.51:30015"
$url = $BASE_URL . "/api/weixin/search-article/v1?token=YOUR_API_KEY&keyword=VALUE";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI Definition (JSON)]

Response Example

Loading the latest successful example...