---
type: "firecrawl-provider"
description: "X (Twitter) promoted posts from X's EU ads repository, with impressions, reach and targeting."
use_when: "X (Twitter) advertisers and their promoted posts from X's EU ads repository."
categories: "Marketing"
capabilities: 2
credits_per_call: "7-8"
---
# Anysite on Firecrawl Alexandria

X (Twitter) promoted posts from X's EU ads repository, with impressions, reach and targeting.

- Categories: Marketing
- Category index: [Marketing category](https://alexandria.firecrawl.dev/agents/categories/marketing)
- Provider key: `anysite`
- Access: Firecrawl credits
- Cost: 7–8 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/anysite)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/anysite/openapi.json)

## Capabilities

- [X advertiser by handle](https://alexandria.firecrawl.dev/agents/providers/anysite/x-ads/advertisers): A list of matching advertisers.
- [X ads by advertiser](https://alexandria.firecrawl.dev/agents/providers/anysite/x-ads/search): A list of promoted posts, one row per post and country.

## 1. Choose this provider when

X (Twitter) advertisers and their promoted posts from X's EU ads repository.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "anysite",
  "capability": "x-ads/advertisers",
  "options": {
    "advertiser": "<advertiser>"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `advertiser` (string, required): X handle of the advertiser, such as Lovable. Example: `<advertiser>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "anysite",
    capability: "x-ads/advertisers",
    options: {
      advertiser: "<advertiser>",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "anysite",
  "capability": "x-ads/advertisers",
  "options": {
    "advertiser": "<advertiser>"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "anysite",
    "capability": "x-ads/advertisers",
    "options": {
      "advertiser": "<advertiser>"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'anysite/x-ads/advertisers' \
  --options '{"advertiser":"<advertiser>"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "anysite",
  "capability": "x-ads/advertisers",
  "options": {
    "advertiser": "<advertiser>"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "anysite",
  "capability": "x-ads/advertisers",
  "options": {
    "advertiser": "<advertiser>"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
[
  {
    "@type": "<@type>",
    "id": "<id>",
    "name": "<name>",
    "alias": "<alias>",
    "image": "<image>"
  }
]
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### X advertiser by handle

- Capability: `x-ads/advertisers`
- Description: A list of matching advertisers.
- Instructions: Confirm an X handle is a known advertiser in X's EU ads repository and read its advertiser id, name and image, before x-ads/search. 8 credits per call.
- Cost: 8 credits per call
- Capability file: [X advertiser by handle](https://alexandria.firecrawl.dev/agents/providers/anysite/x-ads/advertisers)

Accepted options:
- `advertiser` (string, required): X handle of the advertiser, such as Lovable. Example: `<advertiser>`

Response schema example:
```json
[
  {
    "@type": "<@type>",
    "id": "<id>",
    "name": "<name>",
    "alias": "<alias>",
    "image": "<image>"
  }
]
```

### X ads by advertiser

- Capability: `x-ads/search`
- Description: A list of promoted posts, one row per post and country.
- Instructions: List an advertiser's promoted posts from X's EU ads repository for a date range and set of EU or EEA countries, with impressions, reach, targeting and funding. X does not publish ads shown only outside the EU. 8 credits per call, up to 50 ads.
- Cost: 7 credits per call
- Capability file: [X ads by advertiser](https://alexandria.firecrawl.dev/agents/providers/anysite/x-ads/search)

Accepted options:
- `advertiser` (string, required): X handle of the advertiser, such as Lovable. Example: `<advertiser>`
- `start_date` (string, required): Start of the delivery range, YYYY-MM-DD. Example: `<start_date>`
- `end_date` (string, required): End of the delivery range, YYYY-MM-DD. Example: `<end_date>`
- `countries` (string[]): EU or EEA countries where the ads were shown, two letters each. Defaults to FR upstream. Example: `[]`
- `count` (number): Most ads to return, 1 to 50. Example: `50`

Response schema example:
```json
[
  {
    "@type": "<@type>",
    "tweet_id": "<tweet_id>",
    "line_item_id": "<line_item_id>",
    "account_id": "<account_id>",
    "country": "<country>",
    "advertiser": {},
    "funding_instrument": {},
    "approval_status": "<approval_status>",
    "impression_count": 0,
    "reach_count": 0,
    "targeting": []
  }
]
```
