WeChat Official Accounts Article Details API (V6)
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Retrieves content and public metadata for a WeChat Official Account article by its long or short URL. Use it to extract article text, render the body, or collect inline images.
Highlights
Guidance · Recommended for Article Content
V6 returns plain text and an HTML body fragment in one response. Use V4 when you need a complete HTML document.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
token | query | string | Yes | - | Access token for this API service. |
articleUrl | query | string | Yes | - | WeChat Official Account article URL. Use a standard long URL with __biz, mid, idx, and sn, or an article short URL from WeChat. |
Code Samples
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE'text
I want to use the "Article Details (V6)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE
API Endpoint: BASE_URL + /api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/wechat-official-accounts/article-details-v6-en.json
Parameters:
- token (query): Access token for this API service. (Required)
- articleUrl (query): WeChat Official Account article URL. Use a standard long URL with __biz, mid, idx, and sn, or an article short URL from WeChat. (Required)
Return format: safely handle JSON or text according to the actual Content-Type.
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 the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
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
- 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account 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" # Provided by OpenAPI servers
url = BASE_URL + "/api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")js
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
final String url = BASE_URL + "/api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}go
package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/weixin/get-article-detail/v6?token=YOUR_API_KEY&articleUrl=VALUE';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}Response Fields
Key fields in a successful response (code = 0).
| Field path | Type | Description |
|---|---|---|
data | object | Article body and public metadata for the requested WeChat Official Account article. |
data.biz | string | Business account identifier matching __biz in the article URL. |
data.mid | string | Article message identifier, returned as text. |
data.idx | string | Article position in the publication group, returned as text. |
data.sn | string | Article identifier matching sn in the article URL. |
data.article_url | string | Long URL returned for the article. |
data.name | string | Display name of the publishing Official Account. |
data.user_name | string | Original identifier of the publishing Official Account. |
data.pub_time | string | Article publication time as text with second precision. |
data.hd_head_img | string | Avatar image URL of the publishing Official Account. |
data.msg_cdn_url | string | Cover image URL returned for the article. |
data.service_type | string | Reported type code of the Official Account, returned as text. |
data.copyright_stat | string | Reported copyright status code of the article, returned as text. |
data.title | string | Display title of the article. |
data.digest | string | Article summary. It can be empty. |
data.author | string | Credited author of the article. |
data.province_name | string | Region attribution reported for the article. |
data.comment_id | string | Comment thread identifier for the article, returned as text. |
data.msg_daily_idx | string | Index of the publication within the day, returned as text. |
data.item_show_type | string | Reported display type code for the article, returned as text. |
data.picture_url_list | array | URLs of images included in the article. |
data.picture_url_list[] | string | - |
data.text | string | Plain-text representation of the article body. |
data.html | string | Article body as an HTML fragment. |
Response Example
Loading the response example...