# ライブ読み取り

> Web とレジストリをライブで調べる。9 個のツールを、パラメーターと呼び出し例とともに掲載しています。

Source: https://piqline.com/ja/docs/api/reference/direct

Web と公開ネットワークのライブ読み取りです。クレジットを使います。ワークスペースには何も保存されません。

各呼び出しは `POST` リクエストで、キーは `Authorization: Bearer` に入れます。JSON の本文がツールの入力で、レスポンスは `{ "tool": "nom", "output": … }` の形式です。例には必須パラメーターだけを入れています。パラメーターの説明は、エージェントが読むものと同じです。

### `readPage`

公開 Web ページを読み取ります。タイトル、本文（6,000 文字）、検出したフィード、30 件のリンク。

`POST https://piqline.com/api/v1/tools/readPage`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `url` | `string` | はい |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/readPage \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/readPage", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://exemple.fr/article"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/readPage",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "url": "https://exemple.fr/article",
    },
)
output = response.json()["output"]
```

### `searchWeb`

公開 Web を検索して、候補となる URL を見つけます。

`POST https://piqline.com/api/v1/tools/searchWeb`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `query` | `string` | はい |  |
| `limit` | `integer` | いいえ |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/searchWeb \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/searchWeb", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "query": "levée de fonds"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/searchWeb",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "query": "levée de fonds",
    },
)
output = response.json()["output"]
```

### `browserRead`

動的ページや保護されたページを、ブラウザーを強制して読み取ります。形式は `readPage` と同じです。

`POST https://piqline.com/api/v1/tools/browserRead`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `url` | `string` | はい |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/browserRead \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/browserRead", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://exemple.fr/article"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/browserRead",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "url": "https://exemple.fr/article",
    },
)
output = response.json()["output"]
```

### `waybackHistory`

URL の Wayback Machine でのキャプチャ。最初のキャプチャと最近のキャプチャ。

`POST https://piqline.com/api/v1/tools/waybackHistory`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `url` | `string` | はい |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/waybackHistory \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/waybackHistory", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://exemple.fr/article"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/waybackHistory",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "url": "https://exemple.fr/article",
    },
)
output = response.json()["output"]
```

### `registryLookup`

公開レジストリで企業を検索します。Sirene（フランス）、EDGAR（米国）、Companies House（英国）、OpenCorporates。

`POST https://piqline.com/api/v1/tools/registryLookup`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `registry` | `sirene \| edgar \| companies_house \| opencorporates` | はい |  |
| `query` | `string` | はい |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/registryLookup \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"registry":"sirene","query":"levée de fonds"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/registryLookup", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "registry": "sirene",
    "query": "levée de fonds"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/registryLookup",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "registry": "sirene",
        "query": "levée de fonds",
    },
)
output = response.json()["output"]
```

### `socialCatalog`

SNS の読み取りエンドポイントを一覧します（最大 40 件）。プラットフォームで絞り込めます。

`POST https://piqline.com/api/v1/tools/socialCatalog`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `platform` | `string` | いいえ |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/socialCatalog \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/socialCatalog", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/socialCatalog",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `socialCall`

SNS の読み取りエンドポイントを呼び出し、簡略化したアイテムを最大 20 件返します。

`POST https://piqline.com/api/v1/tools/socialCall`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `endpointId` | `string` | はい |  |
| `params` | `object` | はい |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/socialCall \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpointId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","params":{}}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/socialCall", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "endpointId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
    "params": {}
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/socialCall",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "endpointId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
        "params": {},
    },
)
output = response.json()["output"]
```

### `previewSource`

購読する前に、ソースのライブサンプル（5〜10 件）を取得します。

`POST https://piqline.com/api/v1/tools/previewSource`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `platform` | `instagram \| tiktok \| youtube \| twitter \| x \| threads \| linkedin \| reddit \| …` | はい |  |
| `target` | `string` | はい |  |
| `kind` | `page \| group \| marketplace \| profile \| live \| company \| search` | いいえ |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/previewSource \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","target":"texte"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/previewSource", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "platform": "instagram",
    "target": "texte"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/previewSource",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "platform": "instagram",
        "target": "texte",
    },
)
output = response.json()["output"]
```

### `whoSaidItFirst`

ある情報を Web 上で最初に公開したのは誰か、ページごとに調べ、あなたのソースがそれをいつ確認したかを示します。話題またはアイテムから開始し、ワークスペース専用のタイムラインとして保存されます。

`POST https://piqline.com/api/v1/tools/whoSaidItFirst`

種類: ライブ読み取り。スコープ: `explore`。

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `query` | `string` | いいえ |  |
| `itemId` | `string` | いいえ |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/whoSaidItFirst \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/whoSaidItFirst", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/whoSaidItFirst",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```
