---
type: "firecrawl-provider"
description: "Organization, job, team, technology, signal, and conference data from Sumble."
use_when: "Resolve or search organizations, read one organization's signals and confirmed tech stack, and list its teams.\n\nSearch or resolve job posts, and map a raw title to a Sumble job function and level.\n\nFind technology slugs and resolve technology and category names.\n\nTurn a place name into the location code Sumble filters expect.\n\nResolve project names and slugs to Sumble's canonical projects.\n\nSearch the account signal feed and the priority-signal digest.\n\nSearch conferences and the people Sumble matched to them."
categories: "Jobs"
capabilities: 15
pricing: "10 credits per billed unit; see each capability for its unit and maximum."
---
# Sumble on Firecrawl Alexandria

Organization, job, team, technology, signal, and conference data from Sumble.

- Categories: Jobs
- Category index: [Jobs category](https://alexandria.firecrawl.dev/agents/categories/jobs)
- Provider key: `sumble`
- Access: Firecrawl credits
- Cost (Organizations): 10 credits per Sumble credit
- Cost (Organization signals): 10 credits per Sumble credit
- Cost (Organization tech stack): 10 credits per Sumble credit
- Cost (Teams): 10 credits per Sumble credit
- Cost (Job posts): 10 credits per Sumble credit
- Cost (Job title lookup): 10 credits per Sumble credit
- Cost (Technology search): 10 credits per Sumble credit
- Cost (Technology lookup): 10 credits per Sumble credit
- Cost (Technology categories): 10 credits per Sumble credit
- Cost (Location lookup): 10 credits per Sumble credit
- Cost (Project lookup): 10 credits per Sumble credit
- Cost (Signal search): 10 credits per Sumble credit
- Cost (Priority signals): 10 credits per Sumble credit
- Cost (Event search): 10 credits per Sumble credit
- Cost (Event detail): 10 credits per Sumble credit

## More

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

## Capabilities

- [Organizations](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/organizations): organizations is one row per match or result. attributes holds the requested fields. entities holds the requested metrics. total is the match count. credits_used is what Sumble billed. credits_used and credits_remaining are on the response envelope, not on each record.
- [Organization signals](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/signals): signals is the organization's recent feed. An empty array costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- [Organization tech stack](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/tech-stack): business_functions groups categories. technologies lists the primary confirmed technologies. evidence lists every confirmed technology in the category. credits_used and credits_remaining are on the response envelope, not on each record.
- [Teams](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/teams): teams is one row per match or result. credits_used is what Sumble billed. credits_used and credits_remaining are on the response envelope, not on each record.
- [Job posts](https://alexandria.firecrawl.dev/agents/providers/sumble/jobs/posts): jobs is one row per match or result. credits_used is what Sumble billed. credits_used and credits_remaining are on the response envelope, not on each record.
- [Job title lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/jobs/titles): results lines up with titles. job_function or job_level is null when that side did not match. matched_count is how many titles matched at least one side. credits_used and credits_remaining are on the response envelope, not on each record.
- [Technology search](https://alexandria.firecrawl.dev/agents/providers/sumble/technologies/find): technologies holds up to 50 matches. total_count can be larger. credits_used is 0 when the list is empty. credits_used and credits_remaining are on the response envelope, not on each record.
- [Technology lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/technologies/lookup): results lines up with the inputs. matched_count is how many resolved. credits_used and credits_remaining are on the response envelope, not on each record.
- [Technology categories](https://alexandria.firecrawl.dev/agents/providers/sumble/technologies/categories): results lines up with the inputs. matched_count is how many resolved. credits_used and credits_remaining are on the response envelope, not on each record.
- [Location lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/locations/find): locations contains code, name, type, path, expandable, and counts. An empty list costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- [Project lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/projects/lookup): results lines up with the inputs. project is null when nothing matched. credits_used and credits_remaining are on the response envelope, not on each record.
- [Signal search](https://alexandria.firecrawl.dev/agents/providers/sumble/signals/search): signals is the page, newest first. An empty array costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- [Priority signals](https://alexandria.firecrawl.dev/agents/providers/sumble/signals/priority): priority_signals is the page. An empty array costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- [Event search](https://alexandria.firecrawl.dev/agents/providers/sumble/events/search): events is the page. people on each event is a preview of at most three. total counts matches. has_icp says whether the account has an ICP. credits_used and credits_remaining are on the response envelope, not on each record.
- [Event detail](https://alexandria.firecrawl.dev/agents/providers/sumble/events/detail): event is the conference. event.people is the page of matched people. total_people counts matches. credits_used follows the people returned. credits_used and credits_remaining are on the response envelope, not on each record.

## 1. Choose this provider when

Resolve or search organizations, read one organization's signals and confirmed tech stack, and list its teams.

Search or resolve job posts, and map a raw title to a Sumble job function and level.

Find technology slugs and resolve technology and category names.

Turn a place name into the location code Sumble filters expect.

Resolve project names and slugs to Sumble's canonical projects.

Search the account signal feed and the priority-signal digest.

Search conferences and the people Sumble matched to them.

## 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": "sumble",
  "capability": "companies/organizations",
  "options": {
    "organizations": [],
    "select": {},
    "limit": 10
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `organizations` (object[]): Organizations to resolve, each with id, slug, name, or url. Mutually exclusive with filter. Unmatched inputs are free. At most 10, and fewer when paid attributes or metrics are requested. Example: `[]`
- `filter` (object): Advanced query, { query }. Mutually exclusive with organizations. Example: `{}`
- `select` (object, required): attributes lists baseline fields. A matched organization costs 1 Sumble credit. id, slug, name, url, sumble_url, linkedin_url, and account_status do not add another credit. Every other attribute costs 1 Sumble credit per organization. entities lists metric selections. Known attributes: id, slug, name, url, employee_count, industry, jobs_count, teams_count, jobs_count_rollup, jobs_count_no_rollup, teams_count_rollup, teams_count_no_rollup, people_count_rollup, people_count_no_rollup, headquarters_country, sumble_score, sumble_fit, sumble_url, linkedin_url, parent_id, subsidiary_ids, tags, status, status_reason, account_status, funding_total_raised, funding_valuation, funding_last_round_raised, funding_last_round_type, funding_last_round_date, funding_last_round_investors. Example: `{}`
- `include_closed` (boolean): Filter mode only. Include organizations Sumble marks closed. They are excluded by default. Example: `false`
- `limit` (number): Filter mode page size. Omission sends 10, Sumble's default, which is the most a 1-credit row can return under the 100 Firecrawl credit ceiling. Example: `10`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`
- `order_by_column` (string): Filter mode sort. people_concentration and people_count_growth_1y need order_by_job_function. job_post_concentration needs order_by_advanced_query. Example: `<order_by_column>`
- `order_by_direction` (string): ASC or DESC. Filter mode only. Example: `ASC`
- `order_by_job_function` (string): Job function for a people_concentration or people_count_growth_1y sort. Example: `<order_by_job_function>`
- `order_by_advanced_query` (string): Advanced query for a job_post_concentration sort. Example: `<order_by_advanced_query>`
- `match_source` (string): Filter mode. any matches job posts or employee profiles. job_post matches job posts only. Example: `any`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "sumble",
    capability: "companies/organizations",
    options: {
      organizations: [],
      select: {},
      limit: 10,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "sumble",
  "capability": "companies/organizations",
  "options": {
    "organizations": [],
    "select": {},
    "limit": 10
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "sumble",
    "capability": "companies/organizations",
    "options": {
      "organizations": [],
      "select": {},
      "limit": 10
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'sumble/companies/organizations' \
  --options '{"organizations":[],"select":{},"limit":10}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "sumble",
  "capability": "companies/organizations",
  "options": {
    "organizations": [],
    "select": {},
    "limit": 10
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "sumble",
  "capability": "companies/organizations",
  "options": {
    "organizations": [],
    "select": {},
    "limit": 10
  }
}
```

## 6. Response data

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

```json
{
  "organizations": [
    {
      "input": {},
      "attributes": {},
      "entities": []
    }
  ]
}
```

## API reference-derived contract

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

### Organizations

- Capability: `companies/organizations`
- Description: organizations is one row per match or result. attributes holds the requested fields. entities holds the requested metrics. total is the match count. credits_used is what Sumble billed. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Resolve organizations by id, slug, domain, or name, or search them with a Sumble advanced query. A matched organization costs 1 Sumble credit, 10 Firecrawl credits, including a request that asks only for identity fields. Other attributes and each named entity metric add 1 Sumble credit per organization. Unmatched inputs and an empty page cost nothing. A request is refused when its worst case is above 10 Sumble credits. metrics "all" and exploded technology categories are not accepted.
- Cost: 10 credits per Sumble credit
- Capability file: [Organizations](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/organizations)

Accepted options:
- `organizations` (object[]): Organizations to resolve, each with id, slug, name, or url. Mutually exclusive with filter. Unmatched inputs are free. At most 10, and fewer when paid attributes or metrics are requested. Example: `[]`
- `filter` (object): Advanced query, { query }. Mutually exclusive with organizations. Example: `{}`
- `select` (object, required): attributes lists baseline fields. A matched organization costs 1 Sumble credit. id, slug, name, url, sumble_url, linkedin_url, and account_status do not add another credit. Every other attribute costs 1 Sumble credit per organization. entities lists metric selections. Known attributes: id, slug, name, url, employee_count, industry, jobs_count, teams_count, jobs_count_rollup, jobs_count_no_rollup, teams_count_rollup, teams_count_no_rollup, people_count_rollup, people_count_no_rollup, headquarters_country, sumble_score, sumble_fit, sumble_url, linkedin_url, parent_id, subsidiary_ids, tags, status, status_reason, account_status, funding_total_raised, funding_valuation, funding_last_round_raised, funding_last_round_type, funding_last_round_date, funding_last_round_investors. Example: `{}`
- `include_closed` (boolean): Filter mode only. Include organizations Sumble marks closed. They are excluded by default. Example: `false`
- `limit` (number): Filter mode page size. Omission sends 10, Sumble's default, which is the most a 1-credit row can return under the 100 Firecrawl credit ceiling. Example: `10`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`
- `order_by_column` (string): Filter mode sort. people_concentration and people_count_growth_1y need order_by_job_function. job_post_concentration needs order_by_advanced_query. Example: `<order_by_column>`
- `order_by_direction` (string): ASC or DESC. Filter mode only. Example: `ASC`
- `order_by_job_function` (string): Job function for a people_concentration or people_count_growth_1y sort. Example: `<order_by_job_function>`
- `order_by_advanced_query` (string): Advanced query for a job_post_concentration sort. Example: `<order_by_advanced_query>`
- `match_source` (string): Filter mode. any matches job posts or employee profiles. job_post matches job posts only. Example: `any`

Response schema example:
```json
{
  "organizations": [
    {
      "input": {},
      "attributes": {},
      "entities": []
    }
  ]
}
```

### Organization signals

- Capability: `companies/signals`
- Description: signals is the organization's recent feed. An empty array costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Read recent signals for one organization id: champion moves, hiring, technology mentions, projects, and trends. Sumble bills 1 credit per signal returned and publishes no page size, so the quote is 100 Firecrawl credits and a larger Sumble charge still settles at 100. An organization with no signals costs nothing. A 404 is an unknown id.
- Cost: 10 credits per Sumble credit
- Capability file: [Organization signals](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/signals)

Accepted options:
- `organization_id` (number, required): Sumble organization id. Example: `10`
- `technology_slugs` (string[]): Keep signals that mention these technology slugs. Repeat the parameter for more than one. Example: `[]`

Response schema example:
```json
{
  "signals": [
    {
      "title": "<title>",
      "display_type": "<display_type>",
      "date": "<date>",
      "organization_id": 0
    }
  ]
}
```

### Organization tech stack

- Capability: `companies/tech-stack`
- Description: business_functions groups categories. technologies lists the primary confirmed technologies. evidence lists every confirmed technology in the category. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Read the technologies Sumble has confirmed an organization uses, grouped by business function and category. This is stricter than a job-post mention. Sumble bills 1 credit per technology returned and publishes no page size, so the quote is 100 Firecrawl credits and a larger Sumble charge still settles at 100. An organization with no confirmed technologies costs nothing.
- Cost: 10 credits per Sumble credit
- Capability file: [Organization tech stack](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/tech-stack)

Accepted options:
- `organization_id` (number, required): Sumble organization id. Example: `10`
- `custom_technology_categories` (string[]): Custom category slugs, such as custom:cloud. Sumble limits these to its private preview and rejects the rest before charging. Example: `[]`

Response schema example:
```json
{
  "business_functions": [
    {
      "categories": []
    }
  ]
}
```

### Teams

- Capability: `companies/teams`
- Description: teams is one row per match or result. credits_used is what Sumble billed. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Resolve teams by id or list the teams Sumble extracted for one or more organizations. Each team costs 1 Sumble credit plus 1 per paid attribute, related person, and job post. Unmatched ids and an empty page cost nothing. The vendor defaults of 10 related people or 10 job posts plus the base credit exceed 100 Firecrawl credits, so set max_per_team low enough that the worst case stays within 10 Sumble credits.
- Cost: 10 credits per Sumble credit
- Capability file: [Teams](https://alexandria.firecrawl.dev/agents/providers/sumble/companies/teams)

Accepted options:
- `teams` (object[]): Teams to resolve. Each object has team_id. Mutually exclusive with filter. Example: `[]`
- `filter` (object): organization_ids (1 to 1000) and an optional query and since. Mutually exclusive with teams. Example: `{}`
- `select` (object, required): attributes, or "all". team_id, name, and sumble_url are always included free. Every named attribute costs 1 credit, including score. related_people and job_posts add 1 credit per row they return. Known attributes: organization, breadcrumbs, jobs_count, technology_list, job_function_list, location_list, first_activity, last_activity, score. Example: `{}`
- `limit` (number): Filter mode page size. Omission sends 10. Fewer when attributes, related people, or job posts are requested. Sumble's default related_people and job_posts caps are 10, which already exceeds the ceiling together with the base credit, so set max_per_team. Example: `10`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`
- `order_by_column` (string): Filter mode sort. score needs one organization and an ICP on the Sumble account. Example: `jobs_count`
- `order_by_direction` (string): ASC or DESC. Example: `ASC`

Response schema example:
```json
{
  "teams": [
    {
      "team_id": 0,
      "name": "<name>",
      "attributes": {}
    }
  ]
}
```

### Job posts

- Capability: `jobs/posts`
- Description: jobs is one row per match or result. credits_used is what Sumble billed. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Resolve job posts by id or search them by organization and an advanced query. Each returned job costs 1 Sumble credit plus 1 per paid attribute and related person. title is free. Unmatched ids and an empty page cost nothing. The worst case must stay within 10 Sumble credits.
- Cost: 10 credits per Sumble credit
- Capability file: [Job posts](https://alexandria.firecrawl.dev/agents/providers/sumble/jobs/posts)

Accepted options:
- `jobs` (object[]): Jobs to resolve. Each object has job_id. Mutually exclusive with filter. Example: `[]`
- `filter` (object): organization_ids, organization_list_id, and query. A query on its own searches the corpus. Mutually exclusive with jobs. Example: `{}`
- `select` (object, required): attributes, or "all". title is free. job_id and sumble_url are always included free. Every other attribute costs 1 credit. related_people costs 1 credit per person returned. Known attributes: title, description, location, posted_date, organization, technologies, teams, job_functions, job_levels, projects. Example: `{}`
- `limit` (number): Filter mode page size. Omission sends 10. Fewer when paid attributes or related people are requested. Example: `10`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`

Response schema example:
```json
{
  "jobs": [
    {
      "job_id": 0,
      "sumble_url": "<sumble_url>",
      "attributes": {},
      "related_people": []
    }
  ]
}
```

### Job title lookup

- Capability: `jobs/titles`
- Description: results lines up with titles. job_function or job_level is null when that side did not match. matched_count is how many titles matched at least one side. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Map raw job titles to Sumble job functions and levels. 1 Sumble credit per 100 matched titles, so 10 Firecrawl credits per started hundred, and nothing when none match. At most 1000 titles, which is the 100 Firecrawl credit ceiling when every title matches.
- Cost: 10 credits per Sumble credit
- Capability file: [Job title lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/jobs/titles)

Accepted options:
- `titles` (string[], required): Raw job titles, 1 to 1000. Sumble bills 1 credit per 100 matched titles. Unmatched titles are free. Example: `[]`

Response schema example:
```json
{
  "results": [
    {
      "input": "<input>",
      "job_function": {},
      "job_level": {}
    }
  ]
}
```

### Technology search

- Capability: `technologies/find`
- Description: technologies holds up to 50 matches. total_count can be larger. credits_used is 0 when the list is empty. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Search Sumble's technology catalog by name and take the slug other filters expect. 10 Firecrawl credits when any technology is returned. No matches cost nothing.
- Cost: 10 credits per Sumble credit
- Capability file: [Technology search](https://alexandria.firecrawl.dev/agents/providers/sumble/technologies/find)

Accepted options:
- `query` (string, required): Technology name to search. Sumble returns up to 50 matches and bills 1 credit when at least one comes back. Example: `<query>`

Response schema example:
```json
{
  "technologies": [
    {
      "slug": "<slug>",
      "name": "<name>",
      "count": 0
    }
  ]
}
```

### Technology lookup

- Capability: `technologies/lookup`
- Description: results lines up with the inputs. matched_count is how many resolved. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Resolve technology names, slugs, or aliases to canonical technologies. 10 Firecrawl credits per 100 matches. Unmatched inputs are free. At most 1000 names.
- Cost: 10 credits per Sumble credit
- Capability file: [Technology lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/technologies/lookup)

Accepted options:
- `technologies` (string[], required): Technology names, slugs, or aliases. 1 credit per 100 matches. Example: `[]`

Response schema example:
```json
{
  "results": [
    {
      "input": "<input>",
      "technology": {}
    }
  ]
}
```

### Technology categories

- Capability: `technologies/categories`
- Description: results lines up with the inputs. matched_count is how many resolved. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Resolve technology category names or slugs. 10 Firecrawl credits per 100 matches. Unmatched inputs are free. At most 1000 names.
- Cost: 10 credits per Sumble credit
- Capability file: [Technology categories](https://alexandria.firecrawl.dev/agents/providers/sumble/technologies/categories)

Accepted options:
- `technology_categories` (string[], required): Category names or slugs. 1 credit per 100 matches. Example: `[]`

Response schema example:
```json
{
  "results": [
    {
      "input": "<input>",
      "category": {}
    }
  ]
}
```

### Location lookup

- Capability: `locations/find`
- Description: locations contains code, name, type, path, expandable, and counts. An empty list costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Turn a place name or a parent code into the location codes Sumble's hq_location and country filters expect. 10 Firecrawl credits when any location is returned. No matches cost nothing. Sending query and parent together is rejected.
- Cost: 10 credits per Sumble credit
- Capability file: [Location lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/locations/find)

Accepted options:
- `query` (string): Search country, state, and city names. Do not also send parent. Example: `<query>`
- `parent` (string): List children of a region, country, or state code, such as US or US:Texas. Do not also send query. Omit both to list top-level regions and countries. Example: `<parent>`

Response schema example:
```json
{
  "locations": [
    {
      "code": "<code>",
      "name": "<name>",
      "type": "<type>"
    }
  ]
}
```

### Project lookup

- Capability: `projects/lookup`
- Description: results lines up with the inputs. project is null when nothing matched. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Resolve project names or slugs to canonical Sumble projects. 10 Firecrawl credits per 100 matches. Unmatched inputs are free. At most 1000 names.
- Cost: 10 credits per Sumble credit
- Capability file: [Project lookup](https://alexandria.firecrawl.dev/agents/providers/sumble/projects/lookup)

Accepted options:
- `projects` (string[], required): Project names or slugs. 1 credit per 100 matches. Example: `[]`

Response schema example:
```json
{
  "results": [
    {
      "input": "<input>",
      "project": {}
    }
  ]
}
```

### Signal search

- Capability: `signals/search`
- Description: signals is the page, newest first. An empty array costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Search signals across the accounts this credential can see, from the last 60 days unless the filter is signal ids. 10 Firecrawl credits per signal returned. An empty page costs nothing. limit is capped at 10. Omission sends 1.
- Cost: 10 credits per Sumble credit
- Capability file: [Signal search](https://alexandria.firecrawl.dev/agents/providers/sumble/signals/search)

Accepted options:
- `filter` (object): Optional. organization_ids, person_ids, signal_ids, technology_slugs, job_functions, priorities, account_list_ids, and signal_config_ids. Combined with AND. Example: `{}`
- `limit` (number): Signals to return, from 1 to 10. Each returned signal costs 10 Firecrawl credits. Omission sends 1 because Sumble's own default is 100. Example: `1`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`

Response schema example:
```json
{
  "signals": [
    {
      "signal_id": 0,
      "title": "<title>",
      "organization_id": 0,
      "date": "<date>"
    }
  ]
}
```

### Priority signals

- Capability: `signals/priority`
- Description: priority_signals is the page. An empty array costs nothing. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Search the priority-signal digest by organization, person, job post, or source signal. 10 Firecrawl credits per priority signal returned. An empty page costs nothing. limit is capped at 10. Omission sends 1.
- Cost: 10 credits per Sumble credit
- Capability file: [Priority signals](https://alexandria.firecrawl.dev/agents/providers/sumble/signals/priority)

Accepted options:
- `filter` (object): Optional. organization_ids, person_ids, signal_ids, job_post_ids, is_relevant, and has_feedback. Example: `{}`
- `limit` (number): Priority signals to return, from 1 to 10. Omission sends 1 because Sumble's own default is 20. Example: `1`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`

Response schema example:
```json
{
  "priority_signals": [
    {
      "id": 0,
      "title": "<title>"
    }
  ]
}
```

### Event search

- Capability: `events/search`
- Description: events is the page. people on each event is a preview of at most three. total counts matches. has_icp says whether the account has an ICP. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Search conferences and the people Sumble matched to them. 10 Firecrawl credits per event returned. An empty page costs nothing. limit is capped at 10. Omission sends 1. Each event includes up to three of its people.
- Cost: 10 credits per Sumble credit
- Capability file: [Event search](https://alexandria.firecrawl.dev/agents/providers/sumble/events/search)

Accepted options:
- `filter` (object): Optional. period is upcoming, previous, or all. Also locations, keywords, person_ids, organization_ids, job_functions, and job_levels. Example: `{}`
- `order_by_column` (string): relevance or date. Sumble defaults to relevance. Example: `relevance`
- `order_by_direction` (string): Reverses the column's own direction. Example: `ASC`
- `limit` (number): Events to return, from 1 to 10. Omission sends 1 because Sumble's own default is 20. Each returned event costs 10 Firecrawl credits. Example: `1`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`

Response schema example:
```json
{
  "events": [
    {
      "id": 0,
      "name": "<name>",
      "people": []
    }
  ]
}
```

### Event detail

- Capability: `events/detail`
- Description: event is the conference. event.people is the page of matched people. total_people counts matches. credits_used follows the people returned. credits_used and credits_remaining are on the response envelope, not on each record.
- Instructions: Read one conference and the people Sumble matched to it. 10 Firecrawl credits per person returned. A page with no people costs nothing. limit is capped at 10. Omission sends 1. An unknown id is a 404.
- Cost: 10 credits per Sumble credit
- Capability file: [Event detail](https://alexandria.firecrawl.dev/agents/providers/sumble/events/detail)

Accepted options:
- `event_id` (number, required): Sumble event id from events/search. Example: `10`
- `filter` (object): Optional people filters: job_functions, job_levels, organization_ids, locations, account_status, and crm. Example: `{}`
- `limit` (number): People to return, from 1 to 10. Omission sends 1 because Sumble's own default is 100. Each returned person costs 10 Firecrawl credits. Example: `1`
- `offset` (number): Rows to skip. Defaults to 0. Example: `10`

Response schema example:
```json
{
  "event": {
    "id": 0,
    "name": "<name>",
    "people": []
  }
}
```