# Ibef — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive reports on Indian industries and states, browse the latest economic news, and get quick facts about India's economy all in one place. Search across thousands of resources to find detailed insights on specific sectors, regions, and economic trends.

**Category:** Government & Public Data | **Website:** [ibef.org/](https://ibef.org/) | **Docs:** [parse.bot/marketplace/dc949d9d-ca4c-4e0f-b349-e693859a1ab8/ibef-org-api](https://parse.bot/marketplace/dc949d9d-ca4c-4e0f-b349-e693859a1ab8/ibef-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_economy_overview

Fetches the Indian Economy Overview page with macroeconomic indicators, GDP statistics, and sector-wise economic data. Returns the page title and full text content.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_economy_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_india_snapshot

Returns the India at a Glance snapshot page with geographic, demographic, economic, political, and transportation quick facts organized by section. Each section includes heading, content text, optional items list, and optional paragraphs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_india_snapshot \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_industry_list

Returns the full list of all industry sectors covered by IBEF with their URL slugs. Each industry entry includes name, slug, and URL. No parameters required. Use industry slugs to fetch detailed reports via get_industry_report.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_industry_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_industry_report

Fetches the full industry report for a given industry slug, including snapshot text, advantage India points, growth drivers, government initiatives, market size, investments, and related news sections. Slugs are obtained from get_industry_list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Industry slug from get_industry_list results (e.g. 'india-automobiles', 'information-technology-india', 'banking-india'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_industry_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_news_article

Fetches the full content of a specific news article by its URL slug. Use slugUrl from get_news_list results. Returns the article title, publication date, full text content, and URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | News article URL slug from get_news_list results (slugUrl field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_news_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_news_list

Returns the latest news articles from IBEF covering Indian economy and industry. Supports pagination with 10 articles per page. Each article includes id, newsTitle, slugUrl, newsShortDesc, newsAuthor, and createdDate.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_state_report

Fetches the full state or Union Territory report for a given state slug, including snapshot, key statistics, economic scenario, and related news sections. Slugs are obtained from get_states_list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | State slug from get_states_list results (e.g. 'maharashtra', 'karnataka', 'tamil-nadu'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_state_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_states_list

Returns the full list of all Indian states and Union Territories covered by IBEF with their URL slugs. Each entry includes name, slug, and URL. Use state slugs to fetch detailed reports via get_state_report.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/get_states_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search

Performs a site-wide search on IBEF for a given query string. Returns up to 10 results per page with pagination. Each result includes title, url, and description.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed). |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibef-org-api-dc949d9d/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```