---
title: "Web Search & Analysis API"
slug: web-search-analysis
url: https://apyhub.com/skycraft/service/web-search-analysis
provider: Skycraft
categories: [Data Extraction, Data Validation, SEO]
tags: [web-search, content-extraction, page-rank, publish-date, author-extraction, email-verification]
auth: api_key
version: 1.9.0
service_type: sync
endpoints: 5
atoms: 20
mcp: true
---

# Web Search & Analysis API

Search the web, extract webpage content, retrieve website rankings, and find article publication dates and author details using one API.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/skycraft/web-search-analysis/retrieve-page-rank` | What it does Retrieves the page rank information for a domain passed in the query string. The respo… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-publish-date` | What it does Extracts the publish date from the web page at the provided URL and returns it in the… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/web-search-analysis/search-web` | What it does Searches the web for the supplied query and returns a JSON object containing a results… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-content` | What it does Extracts the main content from a web page URL and returns a JSON object containing the… | 20 |
| GET | `https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-authors` | What it does Extracts author information from the page at the provided URL and returns it in a JSON… | 20 |

## Endpoint reference

### Retrieve Page Rank API

`GET https://api.eu.apyhub.com/skycraft/web-search-analysis/retrieve-page-rank` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `domain` | query | string | yes | Example: `amazon.com`. |

#### Quickstart

Look up the page rank for a domain by passing it as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/web-search-analysis/retrieve-page-rank?domain=amazon.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with these optional top-level fields: `position` as an integer, `page_rank` as a number, and `percentile` as a number.

```json
{
  "page_rank": 9.13,
  "position": 30,
  "percentile": 0.9999971
}
```

### Extract Publish Date API

`GET https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-publish-date` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | query | string | yes | Example: `https://www.nytimes.com/2024/03/27/world/australia/economy-cost-of-living.html`. |

#### Quickstart

Extract the publish date from a webpage by passing its `url` as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-publish-date?url=https%3A%2F%2Fwww.nytimes.com%2F2024%2F03%2F27%2Fworld%2Faustralia%2Feconomy-cost-of-living.html" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `publish_date` string field, which may be `null` if the date can't be determined.

```json
{
  "publish_date": "2024-03-27"
}
```

### Search Web API

`GET https://api.eu.apyhub.com/skycraft/web-search-analysis/search-web` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `query` | query | string | yes | Example: `penguins`. |
| `number` | query | integer (int32) | no | Example: `5`. |

#### Quickstart

Search the web for a required query term, optionally limiting the number of results.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/web-search-analysis/search-web?query=penguins" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `results` array. Each item in `results` is an object that may include `url`, `title`, and `summary` strings.

```json
{
  "results": [
    {
      "url": "//duckduckgo.com/l/?uddg=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FPenguin&rut=508a4405e945e3f0eb2e51362f3138ef96e0365e0e80c5c2a92724dc6cf1282a",
      "title": "Penguin - Wikipedia",
      "summary": "Penguins are a group of flightless semi-aquatic sea birds which live almost exclusively in the Southern Hemisphere. Only one species, the Galapagos penguin, lives at, and slightly north of, the equator. Highly adapted for life in the ocean water, penguins have countershaded dark and white plumage and flippers for swimming. Most penguins feed on krill, fish, squid and other forms of sea life ..."
    }
  ]
}
```

### Extract Content from a Web Page API

`GET https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-content` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | query | string | yes | Example: `https://www.nytimes.com/2024/03/27/world/australia/economy-cost-of-living.html`. |

#### Quickstart

Fetch extracted content from a webpage by passing the page URL as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-content?url=https%3A%2F%2Fwww.nytimes.com%2F2024%2F03%2F27%2Fworld%2Faustralia%2Feconomy-cost-of-living.html" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `title`, `images`, `main_html`, and `main_text` fields. `title`, `main_html`, and `main_text` are nullable strings, and `images` is an array of nullable strings.

```json
{
  "title": "Example article title",
  "images": ["https://example.com/image.jpg"],
  "main_html": "<article>...</article>",
  "main_text": "Example extracted article text"
}
```

### Extract Authors API

`GET https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-authors` · 20 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | query | string | yes | Example: `https://www.nytimes.com/2024/03/27/world/australia/economy-cost-of-living.html`. |

#### Quickstart

Fetch authors for a given article URL by passing the URL as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/skycraft/web-search-analysis/extract-authors?url=https%3A%2F%2Fwww.nytimes.com%2F2024%2F03%2F27%2Fworld%2Faustralia%2Feconomy-cost-of-living.html" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `authors` array field. Each item in `authors` is an object with optional `link` and `name` string fields, both of which may be `null`.

```json
{
  "authors": [
    {
      "link": "https://www.nytimes.com/by/jane-doe",
      "name": "Jane Doe"
    }
  ]
}
```

## About

## What it does

The **Web Search & Analysis API** helps you search the web, extract webpage content, retrieve website ranking information, and identify article metadata.

Use **Search Web** to find relevant webpages by providing a search query. Use **Extract Content from a Web Page** to retrieve the title, images, HTML, and main text from a specific webpage by passing its URL.

For article information, use **Extract Publish Date** to retrieve the publication date of an article and **Extract Authors** to identify the author names and profile links. For both endpoints, provide the URL of the specific article or webpage you want to analyze.

Use **Retrieve Page Rank** to get ranking information for a website by providing its domain name. The response includes the position, page rank score, and percentile.

These endpoints are useful for web research, content analysis, SEO insights, and article metadata extraction.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/skycraft/service/web-search-analysis
