# Facebook

> Facebook. 도구 8개와 매개변수, 호출 예제.

Source: https://piqline.com/ko/docs/api/reference/facebook

Facebook 에이전트의 도구입니다. Marketplace 매물과 공개 그룹을 실시간으로 읽습니다.

각 호출은 `Authorization: Bearer`에 키를 넣은 `POST` 요청입니다. JSON 본문이 도구의 입력이며, 응답은 `{ "tool": "nom", "output": … }` 형태입니다. 예제에는 필수 매개변수만 포함되어 있습니다. 매개변수 설명은 에이전트가 읽는 설명과 같습니다.

### `findMarketplaceLocation`

도시 또는 지역 이름을 Marketplace 좌표로 변환합니다.

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `query` | `string` | 예 | City or area name, e.g. 'Lyon' or 'Austin, Texas' |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/findMarketplaceLocation \
  -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/findMarketplaceLocation", {
  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/findMarketplaceLocation",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "query": "levée de fonds",
    },
)
output = response.json()["output"]
```

### `searchMarketplace`

장소(도시 또는 좌표) 주변의 공개 Marketplace 매물을 키워드로 검색합니다. 최대 3페이지.

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `query` | `string` | 예 | Search keyword(s) |
| `location` | `string` | 아니요 | City or area name; ignored when lat and lng are both given |
| `lat` | `number` | 아니요 |  |
| `lng` | `number` | 아니요 |  |
| `radiusKm` | `integer` | 아니요 |  |
| `minPrice` | `number` | 아니요 |  |
| `maxPrice` | `number` | 아니요 |  |
| `count` | `integer` | 아니요 |  |
| `pages` | `integer` | 아니요 | Pages to chain in one call (1 credit each); dedupes listings |
| `sortBy` | `suggested \| creation_time_descend \| distance_ascend \| price_ascend \| price_descend` | 아니요 |  |
| `delivery` | `all \| local_pickup \| shipping` | 아니요 |  |
| `condition` | `new \| used_like_new \| used_good \| used_fair` | 아니요 |  |
| `dateListed` | `all \| last_24_hours \| last_7_days \| last_30_days` | 아니요 |  |
| `availability` | `available \| sold \| all` | 아니요 |  |
| `categoryId` | `string` | 아니요 | Numeric Marketplace category id, as returned in listings |
| `exclude` | `array<string>` | 아니요 | Drop listings whose title contains any of these words (e.g. 'pièces', 'cadre seul') |
| `include` | `array<string>` | 아니요 | Keep only listings whose title contains at least one of these words |
| `cursor` | `string` | 아니요 | Opaque cursor from a previous page |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/searchMarketplace \
  -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/searchMarketplace", {
  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/searchMarketplace",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "query": "levée de fonds",
    },
)
output = response.json()["output"]
```

### `getMarketplaceListing`

매물의 상세: 설명, 속성, 사진, 배송, Facebook이 제공하는 경우 정확한 날짜.

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `listing` | `string` | 예 | Listing id or Marketplace item URL |

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

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

### `getMarketplaceListings`

매물 2~6개의 상세를 비교 표로 한 번에 가져옵니다.

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `listings` | `array<string>` | 예 | Listing ids or Marketplace item URLs |

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

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

### `getFacebookGroup`

그룹의 공개 프로필: 공개 범위, 규모, 활동, 카테고리, 규칙.

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `group` | `string` | 예 | Group URL, numeric id, or vanity slug |

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

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

### `getFacebookGroupPosts`

공개 그룹의 게시물을 3개씩 페이지로 가져옵니다(최대 6페이지).

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `group` | `string` | 예 | Group URL, numeric id, or vanity slug |
| `sortBy` | `CHRONOLOGICAL \| CHRONOLOGICAL_LISTINGS \| TOP_POSTS \| RECENT_ACTIVITY` | 아니요 |  |
| `pages` | `integer` | 아니요 |  |
| `keywords` | `array<string>` | 아니요 | Keep only posts containing at least one of these terms |
| `since` | `string` | 아니요 | ISO date; posts older than this are dropped and chronological paging stops there |
| `cursor` | `string` | 아니요 |  |

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

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

### `getFacebookPost`

공개 게시물 또는 릴스의 상세: 텍스트, 작성자, 날짜, 반응, 조회수.

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `post` | `string` | 예 | Post or reel URL |

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

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

### `getFacebookPostComments`

공개 게시물의 댓글을 키워드로 필터링할 수 있습니다(최대 3페이지).

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

유형: 실시간 읽기. 스코프: `explore`.

| 매개변수 | 형식 | 필수 | 설명 |
| --- | --- | --- | --- |
| `post` | `string` | 예 | Post or reel URL |
| `pages` | `integer` | 아니요 |  |
| `keywords` | `array<string>` | 아니요 |  |
| `cursor` | `string` | 아니요 |  |

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

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