WeChat Official Accounts Article Details API (V1)
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Retrieves a WeChat Official Account article by URL with selectable plain-text or rich-text content mode. Use it to collect a known article in the preferred representation for reading, extraction, or storage.
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 used to fetch article detail content and metadata. |
mode | query | string | No | TEXT | Article body format. TEXT returns plain text, and RICH_TEXT returns rich text when supported. Available Values: - TEXT: Plain text article detail- RICH_TEXT: Rich text article detail |
Code Samples
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/weixin/get-article-detail/v1?token=YOUR_API_KEY&articleUrl=VALUE'text
I want to use the "Article Details (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/weixin/get-article-detail/v1?token=YOUR_API_KEY&articleUrl=VALUE
API Endpoint: BASE_URL + /api/weixin/get-article-detail/v1?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-v1-en.json
Parameters:
- token (query): Access token for this API service. (Required)
- articleUrl (query): WeChat Official Account article URL used to fetch article detail content and metadata. (Required)
- mode (query): Article body format. TEXT returns plain text, and RICH_TEXT returns rich text when supported.
Available Values:
- `TEXT`: Plain text article detail
- `RICH_TEXT`: Rich text article detail
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/v1?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/v1?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/v1?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/v1?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/v1?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).
Article and content15 fields
data
Article content and metadata. A successful response can also contain null data.
| Field | Type | Description |
|---|---|---|
title | string | Display title of the article. |
desc | string | Article summary text. It can be empty. |
author | string | Displayed author name. It can be an empty string. |
biz | string | Public account identifier associated with the article. |
mid | string | Article message identifier, returned as text. |
idx | string | Article index within the message, returned as text. |
url | string | Link reported for the article. |
create_time | string | Reported article creation time as date and time text. |
create_time_str | string | Reported article creation time in display form. |
pubtime | string | Reported publication time of the article as text. |
copyright_stat | integer | Reported copyright status code for the article. |
content | string | Article body representation. In two paired checks, TEXT contained markup and RICH_TEXT returned plain text. |
content_multi_text | string | Article body as HTML when returned. The HTML was identical across modes in both paired checks. |
claim_source_info | object | Displayed article attribution information. |
claim_source_info.claim_source | string | Source attribution text displayed with the article. It can be empty. |
Publishing Official Account8 fields
data
| Field | Type | Description |
|---|---|---|
user_name | string | Username reported for the publishing Official Account. |
nick_name | string | Display name of the publishing Official Account. |
alias | string | Alias reported for the Official Account. It can be empty. |
service_type | string | Reported service type code for the Official Account. |
verify_status | string | Reported verification status code of the Official Account. |
round_head_img | string | Rounded profile image URL reported for the Official Account. |
ori_head_img_url | string | Original profile image URL reported for the Official Account. |
mp_head_img | string | Profile image URL provided for the publishing Official Account. |
Cover, images, and video14 fields
data
| Field | Type | Description |
|---|---|---|
cdn_url | string | Cover image URL reported for the article. |
cdn_url_1_1 | string | Cover image URL for the square presentation. |
cdn_url_235_1 | string | Cover image URL for the wide presentation. |
cdn_url_16_9 | string | Cover image URL for the 16 by 9 presentation. It can be empty. |
picture_page_info_list | array | Image records reported with the article. |
picture_page_info_list[] | object | One image record provided with the article. |
picture_page_info_list[].cdn_url | string | URL for the article image. |
picture_page_info_list[].width | integer | Reported image width in pixels. It can be zero. |
picture_page_info_list[].height | integer | Reported image height in pixels. It can be zero. |
video_snap_card | object | Video card information returned with the article. The object can be empty. |
video_snap_card.list | array | Video cards included with the article, when provided. |
video_snap_card.list[] | object | One video card included with the article. |
video_snap_card.list[].username | string | Account username provided for this video card. |
video_snap_card.list[].export_id | string | Video export identifier provided for the card. |
Engagement7 fields
data
| Field | Type | Description |
|---|---|---|
read | integer | Reported article read count. |
zan | integer | Reported article like count. |
looking | integer | Reported count of the WeChat recommendation action known as 在看. |
share_count | integer | Reported article share count. |
collect_count | integer | Reported count of saves for the article. |
comment_count | integer | Reported article comment count. |
comment_id | string | Comment section identifier reported for the article. |
Displayed region3 fields
data
| Field | Type | Description |
|---|---|---|
countryName | string | Country name displayed with the article. |
provinceName | string | Province name displayed with the article. |
country_id | string | Country identifier reported with the article, returned as text. |
Response Example
Loading the response example...