简体中文

English

简体中文

English

AP News Search

AP News Search 用于按关键词获取 AP News 搜索结果数据。

  • 按关键词抓取 AP News 新闻搜索结果
  • 支持按地区发起请求
  • 支持从指定页开始连续抓取多页结果
  • 返回结果列表、分页信息和文章元数据

使用 XCrawl 获取 AP News 搜索结果

使用方式

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY'\
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "apnews_search",
    "keyword": "coffee",
    "location": "US",
    "start_page": 1,
    "pages": 1
  }'

请求参数说明：

  • engine 固定为 apnews_search
  • keyword 用于指定搜索关键词
  • location 用于指定请求地区
  • start_page 和 pages 用于控制抓取页码范围

响应示例

{
  "result": [
    {
      "content": {
        "query": "coffee",
        "base_url": "https://apnews.com",
        "current_page": 1,
        "total_pages": 20,
        "page_size": 30,
        "result_count": 30,
        "total_results": 9517,
        "next_page_url": "https://apnews.com/search?q=coffee&p=2",
        "source_url": "https://apnews.com/search?q=coffee&p=1",
        "result": [
          {
            "position": 1,
            "title": "Soaring coffee prices rewrite some Americans' daily routines",
            "summary": "Rising coffee prices are changing how some Americans get their caffeine.",
            "url": "https://apnews.com/article/coffee-inflation-prices-starbucks-1a809b2d3e650d5e92e2c0f5a5f4f85b",
            "article_id": "coffee-inflation-prices-starbucks-1a809b2d3e650d5e92e2c0f5a5f4f85b",
            "published_at": "2026-02-14T14:00:07+00:00",
            "updated_at": "2026-02-14T16:58:45+00:00",
            "image_url": "https://dims.apnews.com/...",
            "source": "AP News",
            "content_type": "article"
          }
        ]
      }
    }
  ]
}

参数说明

必填参数

参数类型说明
locationstring指定请求地区。
keywordstring指定搜索关键词。
start_pagenumber指定从第几页开始抓取。
pagesnumber指定连续抓取的页数。

参数补充说明

  • location 默认值为 US
  • location 支持多个地区值，例如 US、HK、CA、GB、JP
  • keyword 默认值为 coffee
  • start_page 默认值为 1
  • pages 默认值为 1

响应字段

响应数据位于 result[].content。

字段类型说明
querystring最终生效的搜索关键词。
base_urlstring用于补全相对链接的站点基础地址。
current_pagenumber当前结果页码。
total_pagesnumber搜索结果总页数。
page_sizenumber当前页包含的结果数量。
result_countnumber当前响应实际返回的结果数量。
total_resultsnumber搜索结果总条数。
next_page_urlstring下一页结果链接。
source_urlstring本次抓取的原始搜索页链接。
resultarray搜索结果列表。

结果项字段

result[] 中每一项通常包含以下字段：

字段类型说明
positionnumber当前页内的结果位置，从 1 开始。
titlestring新闻标题。
summarystring结果摘要。
contentstring内容摘要字段，通常与摘要文本一致。
urlstring文章详情链接。
pathstring文章链接的路径部分。
article_idstring从文章链接中解析出的文章标识。
domainstring结果对应的域名。
display_datestring页面展示的日期文本。
timestamp_msstring页面主时间戳，单位为毫秒。
published_timestamp_msstring发布时间戳，单位为毫秒。
updated_timestamp_msstring更新时间戳，单位为毫秒。
published_atstringISO 8601 格式的发布时间。
updated_atstringISO 8601 格式的更新时间。
image_urlstring主图链接。
image_srcsetstring响应式图片 srcset 信息。
image_altstring图片替代文本。
image_widthnumber图片宽度。
image_heightnumber图片高度。
image_aspect_rationumber图片宽高比。
has_imageboolean是否包含图片。
has_mediaboolean是否包含媒体内容。
gtm_regionstring结果卡片中的 GTM 区域标识。
gtm_topicstring结果卡片中的 GTM 主题标识。
origin_templatestring结果卡片声明的模板名称。
mobile_alt_layoutboolean是否启用了移动端替代布局。
sourcestring来源名称。
content_typestring根据结果链接归一化后的内容类型。