--- type: "firecrawl-provider" description: "Search enriched news, resolve and enrich companies, build company lists, and search industries." use_when: "Search enriched news articles by company, industry, topic, or title.\n\nResolve, enrich, list, and read signals for a company.\n\nResolve a free-text industry into Akta industry codes." categories: "News" capabilities: 6 pricing: "0–100 credits per billed unit; see each capability for its unit and maximum." --- # Akta on Firecrawl Alexandria Search enriched news, resolve and enrich companies, build company lists, and search industries. - Categories: News - Category index: [News category](https://alexandria.firecrawl.dev/agents/categories/news) - Provider key: `akta` - Access: Firecrawl credits - Cost (News search): 2 credits per call - Cost (Company search): 0 credits per call - Cost (Company enrichment): 100 credits per call - Cost (Company list): 85 credits per call - Cost (Filter builder): 100 credits per call - Cost (Industry search): 0 credits per call - Delivery: First 100 words of each matching article ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/akta) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/akta/openapi.json) ## Capabilities - [News search](https://alexandria.firecrawl.dev/agents/providers/akta/news/search): Articles under data. The envelope also has status, total, count, limit, offset, and credits_consumed. HTTP 204 is no match. Published examples also include id and named entities beyond the OpenAPI article schema. - [Company search](https://alexandria.firecrawl.dev/agents/providers/akta/companies/search): Matches under data. credits_consumed is 0. HTTP 204 is no match. - [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/akta/companies/enrich): One company under data, with uuid and one object per requested section. The envelope has status, count, and credits_consumed. - [Company list](https://alexandria.firecrawl.dev/agents/providers/akta/companies/list): Companies under data. The envelope has count, total_count (capped at 500), and credits_consumed. - [Filter builder](https://alexandria.firecrawl.dev/agents/providers/akta/companies/filters): One object under data with filters, plus credits_consumed. Pass filters to companies/list. - [Industry search](https://alexandria.firecrawl.dev/agents/providers/akta/industries/search): Matches under data, highest similarity first. The envelope has count and credits_consumed, which is 0. HTTP 204 is no match. ## 1. Choose this provider when Search enriched news articles by company, industry, topic, or title. Resolve, enrich, list, and read signals for a company. Resolve a free-text industry into Akta industry codes. ## Article preview policy News providers return metadata plus the first 100 words of each matching article. They are not wrapped third-party APIs and do not return full article text. ## 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": "akta", "capability": "news/search", "options": { "query": "", "limit": 10, "offset": 0 } } ``` ## 3. Add provider options Use only the options needed for the task: - `company` (string): Website or company UUID. Articles mentioning the company. Cannot be combined with primary_company. Example: `` - `primary_company` (string): Website or company UUID. Only articles where this company is the primary subject. Example: `` - `industry` (string): Comma-separated Akta industry codes from industries/search. Example: `` - `query` (string): Open-ended topic, such as crude oil price developments. Cannot be combined with title. Example: `` - `title` (string): Match article titles. Cannot be combined with query. Example: `` - `start_date` (string): Range start, YYYY-MM-DD. Non-enterprise plans look back six months. Example: `<start_date>` - `end_date` (string): Range end, YYYY-MM-DD. Akta's default is today. Example: `<end_date>` - `limit` (number): Articles to return. Default 10. Maximum 100. Example: `10` - `offset` (number): Articles to skip. Example: `0` - `group_articles` (boolean): Group similar articles from the same event. The reference page calls this unique_article; the OpenAPI name is group_articles. Example: `false` - `news_score_list` (string): Score tier. Default all. Example: `High` - `countries` (string): Comma-separated ISO country codes for the event country. Example: `<countries>` - `blacklisted` (string): Comma-separated publisher domains to exclude. Example: `<blacklisted>` - `type_list` (string): Comma-separated news type codes. Default all. Example: `<type_list>` - `sentiment_list` (string): Comma-separated sentiments: positive, negative, neutral, all. Default all. Example: `<sentiment_list>` - `entity_person_list` (string): Comma-separated people names. Example: `<entity_person_list>` - `entity_location_list` (string): Comma-separated locations. Example: `<entity_location_list>` - `entity_product_list` (string): Comma-separated product names. Example: `<entity_product_list>` - `entity_event_list` (string): Comma-separated event names. Example: `<entity_event_list>` - `naics_code_list` (string): Comma-separated NAICS codes. Example: `<naics_code_list>` - `sic_code_list` (string): Comma-separated SIC codes. Example: `<sic_code_list>` - `iptc_code_list` (string): Comma-separated IPTC codes. Example: `<iptc_code_list>` - `iab_code_list` (string): Comma-separated IAB codes. Example: `<iab_code_list>` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "akta", capability: "news/search", options: { query: "<query>", limit: 10, offset: 0, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "akta", "capability": "news/search", "options": { "query": "<query>", "limit": 10, "offset": 0 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "akta", "capability": "news/search", "options": { "query": "<query>", "limit": 10, "offset": 0 } } }' ``` ### CLI ```sh firecrawl scrape 'akta/news/search' \ --options '{"query":"<query>","limit":10,"offset":0}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "akta", "capability": "news/search", "options": { "query": "<query>", "limit": 10, "offset": 0 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "akta", "capability": "news/search", "options": { "query": "<query>", "limit": 10, "offset": 0 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "data": [ { "title": "<title>", "url": "<url>", "publisher": "<publisher>", "published_date": "<published_date>", "sentiment": "<sentiment>", "news_score": 0, "ai_summary": "<ai_summary>", "full_text": "<full_text>", "original_language": "<original_language>", "author": "<author>", "countries": [], "industries": [], "types": [], "company_mentions": [] } ] } ``` ## API reference-derived contract This provider returns article metadata and a 100-word preview; use the source URL for the complete article. ### News search - Capability: `news/search` - Description: Articles under data. The envelope also has status, total, count, limit, offset, and credits_consumed. HTTP 204 is no match. Published examples also include id and named entities beyond the OpenAPI article schema. - Instructions: Search enriched news: AI summary, full text, sentiment, event tags, industries, and company mentions. Filter by company, industry, topic, title, date, or entity. A call has a base charge plus a charge per article. Use industries/search for industry codes and companies/search for a company UUID. - Cost: 2 credits per call - Capability file: [News search](https://alexandria.firecrawl.dev/agents/providers/akta/news/search) Accepted options: - `company` (string): Website or company UUID. Articles mentioning the company. Cannot be combined with primary_company. Example: `<company>` - `primary_company` (string): Website or company UUID. Only articles where this company is the primary subject. Example: `<primary_company>` - `industry` (string): Comma-separated Akta industry codes from industries/search. Example: `<industry>` - `query` (string): Open-ended topic, such as crude oil price developments. Cannot be combined with title. Example: `<query>` - `title` (string): Match article titles. Cannot be combined with query. Example: `<title>` - `start_date` (string): Range start, YYYY-MM-DD. Non-enterprise plans look back six months. Example: `<start_date>` - `end_date` (string): Range end, YYYY-MM-DD. Akta's default is today. Example: `<end_date>` - `limit` (number): Articles to return. Default 10. Maximum 100. Example: `10` - `offset` (number): Articles to skip. Example: `0` - `group_articles` (boolean): Group similar articles from the same event. The reference page calls this unique_article; the OpenAPI name is group_articles. Example: `false` - `news_score_list` (string): Score tier. Default all. Example: `High` - `countries` (string): Comma-separated ISO country codes for the event country. Example: `<countries>` - `blacklisted` (string): Comma-separated publisher domains to exclude. Example: `<blacklisted>` - `type_list` (string): Comma-separated news type codes. Default all. Example: `<type_list>` - `sentiment_list` (string): Comma-separated sentiments: positive, negative, neutral, all. Default all. Example: `<sentiment_list>` - `entity_person_list` (string): Comma-separated people names. Example: `<entity_person_list>` - `entity_location_list` (string): Comma-separated locations. Example: `<entity_location_list>` - `entity_product_list` (string): Comma-separated product names. Example: `<entity_product_list>` - `entity_event_list` (string): Comma-separated event names. Example: `<entity_event_list>` - `naics_code_list` (string): Comma-separated NAICS codes. Example: `<naics_code_list>` - `sic_code_list` (string): Comma-separated SIC codes. Example: `<sic_code_list>` - `iptc_code_list` (string): Comma-separated IPTC codes. Example: `<iptc_code_list>` - `iab_code_list` (string): Comma-separated IAB codes. Example: `<iab_code_list>` Response schema example: ```json { "data": [ { "title": "<title>", "url": "<url>", "publisher": "<publisher>", "published_date": "<published_date>", "sentiment": "<sentiment>", "news_score": 0, "ai_summary": "<ai_summary>", "full_text": "<full_text>", "original_language": "<original_language>", "author": "<author>", "countries": [], "industries": [], "types": [], "company_mentions": [] } ] } ``` ### Company search - Capability: `companies/search` - Description: Matches under data. credits_consumed is 0. HTTP 204 is no match. - Instructions: Resolve a company name, website, or UUID to uuid, name, website, product category, and status. Free. Use the uuid on companies/enrich and the signal calls. An empty match costs nothing. - Cost: 0 credits per call - Capability file: [Company search](https://alexandria.firecrawl.dev/agents/providers/akta/companies/search) Accepted options: - `query` (string, required): Company name, website, or UUID. Akta detects which. Example: `<query>` Response schema example: ```json { "data": [ { "uuid": "<uuid>", "name": "<name>", "website": "<website>", "product_category": "<product_category>", "company_status": "<company_status>" } ] } ``` ### Company enrichment - Capability: `companies/enrich` - Description: One company under data, with uuid and one object per requested section. The envelope has status, count, and credits_consumed. - Instructions: Enrich one company with the sections you name: firmographics, business model, assessment, trust, hierarchy, digital presence, financials, location, management, products, strategy, customers, industry, technology, and, on subscription or enterprise, funding and M&A. A miss with credits_consumed of 0 costs nothing. - Cost: 100 credits per call - Capability file: [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/akta/companies/enrich) Accepted options: - `company` (string, required): Company website or UUID from companies/search. Example: `<company>` - `sections` (string, required): Comma-separated sections. firmographic, business_model, company_assessment, trust_signal, company_hierarchy, digital_presence, financial_estimate, location, management_profile, product_offering, strategic_signal, customer_profile, industry, technology, funding_detail, mna_and_investment. funding_detail and mna_and_investment need a subscription or enterprise plan. Example: `<sections>` Response schema example: ```json { "data": { "uuid": "<uuid>", "firmographic": {}, "business_model": {}, "company_assessment": {}, "trust_signal": {}, "company_hierarchy": {}, "digital_presence": {}, "financial_estimate": {}, "location": {}, "management_profile": {}, "product_offering": {}, "strategic_signal": {}, "customer_profile": {}, "industry": {}, "technology": {}, "funding_detail": {}, "mna_and_investment": {} } } ``` ### Company list - Capability: `companies/list` - Description: Companies under data. The envelope has count, total_count (capped at 500), and credits_consumed. - Instructions: Build a company list from structured filters or a natural-language query. Identity fields come back (uuid, name, website). Enrich a chosen company with companies/enrich. A query call is capped at 100 Firecrawl credits. An empty page is free when Akta reports credits_consumed of 0. - Cost: 85 credits per call - Capability file: [Company list](https://alexandria.firecrawl.dev/agents/providers/akta/companies/list) Accepted options: - `query` (string): Natural-language company search. Cannot be combined with filters. limit is capped at 1. Example: `<query>` - `filters` (object): Structured filters from companies/filters. Dotted keys such as firmographic.company_type and location.hq.country. Cannot be combined with query. Example: `{}` - `sections` (string[]): Company sections to attach. Rejected: any section on one company exceeds the 100 Firecrawl credit cap. Use companies/enrich. Example: `[]` - `sort_by` (string): Sort field. Default relevance. Example: `relevance` - `sort_order` (string): Sort direction. Default desc. Example: `asc` - `limit` (number): Companies to return. Omission sends 1. Filters allow 2. A query allows 1. Akta's own maximum is 500, and 20 on pay-as-you-go. Example: `2` - `offset` (number): Companies to skip. Example: `0` Response schema example: ```json { "data": [ { "uuid": "<uuid>", "name": "<name>", "website": "<website>" } ] } ``` ### Filter builder - Capability: `companies/filters` - Description: One object under data with filters, plus credits_consumed. Pass filters to companies/list. - Instructions: Turn a plain-language company description into the filters object companies/list accepts. Does not return companies. A completed translation is charged. A run Akta does not bill costs nothing. - Cost: 100 credits per call - Capability file: [Filter builder](https://alexandria.firecrawl.dev/agents/providers/akta/companies/filters) Accepted options: - `query` (string, required): Natural-language description of the companies to filter, such as series A companies in Mumbai working in climate tech. Example: `<query>` Response schema example: ```json { "data": { "filters": {} } } ``` ### Industry search - Capability: `industries/search` - Description: Matches under data, highest similarity first. The envelope has count and credits_consumed, which is 0. HTTP 204 is no match. - Instructions: Resolve a free-text industry into Akta industry codes ranked by similarity. Free. Pass a code to news/search or to a list filter. An empty match is an empty data array and still costs nothing. - Cost: 0 credits per call - Capability file: [Industry search](https://alexandria.firecrawl.dev/agents/providers/akta/industries/search) Accepted options: - `query` (string, required): Free-text industry or topic, such as warehouse automation. Example: `<query>` - `level` (string): Comma-separated taxonomy levels: l1, l2, l3, l4, all. Default l4. Example: `<level>` Response schema example: ```json { "data": [ { "code": "<code>", "industry_name": "<industry_name>", "similarity": 0 } ] } ```