Skip to content

WeChat Official Accounts Article Details API (V1) ​

GET
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 ​

NameInTypeRequiredDefaultDescription
tokenquerystringYes-Access token for this API service.
articleUrlquerystringYes-WeChat Official Account article URL used to fetch article detail content and metadata.
modequerystringNoTEXTArticle 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.

FieldTypeDescription
titlestringDisplay title of the article.
descstringArticle summary text. It can be empty.
authorstringDisplayed author name. It can be an empty string.
bizstringPublic account identifier associated with the article.
midstringArticle message identifier, returned as text.
idxstringArticle index within the message, returned as text.
urlstringLink reported for the article.
create_timestringReported article creation time as date and time text.
create_time_strstringReported article creation time in display form.
pubtimestringReported publication time of the article as text.
copyright_statintegerReported copyright status code for the article.
contentstringArticle body representation. In two paired checks, TEXT contained markup and RICH_TEXT returned plain text.
content_multi_textstringArticle body as HTML when returned. The HTML was identical across modes in both paired checks.
claim_source_infoobjectDisplayed article attribution information.
claim_source_info.claim_sourcestringSource attribution text displayed with the article. It can be empty.
Publishing Official Account8 fields

data

FieldTypeDescription
user_namestringUsername reported for the publishing Official Account.
nick_namestringDisplay name of the publishing Official Account.
aliasstringAlias reported for the Official Account. It can be empty.
service_typestringReported service type code for the Official Account.
verify_statusstringReported verification status code of the Official Account.
round_head_imgstringRounded profile image URL reported for the Official Account.
ori_head_img_urlstringOriginal profile image URL reported for the Official Account.
mp_head_imgstringProfile image URL provided for the publishing Official Account.
Cover, images, and video14 fields

data

FieldTypeDescription
cdn_urlstringCover image URL reported for the article.
cdn_url_1_1stringCover image URL for the square presentation.
cdn_url_235_1stringCover image URL for the wide presentation.
cdn_url_16_9stringCover image URL for the 16 by 9 presentation. It can be empty.
picture_page_info_listarrayImage records reported with the article.
picture_page_info_list[]objectOne image record provided with the article.
picture_page_info_list[].cdn_urlstringURL for the article image.
picture_page_info_list[].widthintegerReported image width in pixels. It can be zero.
picture_page_info_list[].heightintegerReported image height in pixels. It can be zero.
video_snap_cardobjectVideo card information returned with the article. The object can be empty.
video_snap_card.listarrayVideo cards included with the article, when provided.
video_snap_card.list[]objectOne video card included with the article.
video_snap_card.list[].usernamestringAccount username provided for this video card.
video_snap_card.list[].export_idstringVideo export identifier provided for the card.
Engagement7 fields

data

FieldTypeDescription
readintegerReported article read count.
zanintegerReported article like count.
lookingintegerReported count of the WeChat recommendation action known as 在看.
share_countintegerReported article share count.
collect_countintegerReported count of saves for the article.
comment_countintegerReported article comment count.
comment_idstringComment section identifier reported for the article.
Displayed region3 fields

data

FieldTypeDescription
countryNamestringCountry name displayed with the article.
provinceNamestringProvince name displayed with the article.
country_idstringCountry identifier reported with the article, returned as text.

Response Example ​

Loading the response example...