Global Market Reports API v1

Access comprehensive market research reports and industry data programmatically.

The GMR API provides RESTful endpoints to search, retrieve, and analyze market intelligence data. All endpoints require authentication and are rate-limited to ensure fair access for all users.

Base URL: https://www.globalmarketreports.com/v1

Features

Search reports by keyword, industry, and date range
Retrieve detailed report metadata and pricing
Access industry classifications and market segments
Paginated results with flexible filtering and sorting
CORS-enabled for cross-origin requests
JSON responses with consistent error handling

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header with the Bearer scheme:

Authorization: Bearer gmr_live_your_api_key_here

API Key Format

Production: Prefix gmr_live_ followed by a 32-character key
Test: Prefix gmr_test_ (available upon request)

How to Get an API Key

Log in to your Global Market Reports account
Navigate to Settings → API Keys
Click "Generate API Key" and give it a name
Copy the key immediately (it won't be shown again)
Use it in the Authorization header for all requests

Generate API Key

Invalid or Missing Authorization

Returns 401 Unauthorized. Check that:

Your API key is included in the Authorization header
The key format is correct: Authorization: Bearer gmr_live_...
The key hasn't expired (check your dashboard)
Your account is active

Rate Limiting

The API enforces rate limiting to ensure fair access. Your quota is reset every hour (UTC).

Rate Limit: 1000 requests per hour

Checking Your Rate Limit Status

All API responses include rate limit headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 845
X-RateLimit-Reset: 1649508000

Rate Limit Exceeded

When you exceed the rate limit, the API returns 429 Too Many Requests. The Retry-After header indicates how many seconds to wait before retrying.

HTTP/1.1 429 Too Many Requests
Retry-After: 3600
Content-Type: application/json

{
    "error": {
        "code": 429,
        "message": "Rate limit exceeded. Please try again in 3600 seconds."
    }
}

Tips to Avoid Rate Limits

Cache frequently accessed data locally
Use pagination to fetch results in batches
Implement exponential backoff for retries
Monitor the X-RateLimit-Remaining header

Endpoints

GET /v1/reports

List all published market reports with filtering, pagination, and sorting.

Query Parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number for pagination
`per_page`	integer	20	Results per page (max 100)
`industry`	string	-	Filter by industry slug
`search`	string	-	Search in title and description
`sort`	string	newest	Sort by: newest, oldest, price_asc, price_desc, popular

Response Example

{
    "success": true,
    "data": [
        {
            "id": 1,
            "title": "Global Artificial Intelligence Market",
            "slug": "global-ai-market-2024",
            "subtitle": "2024-2030 Analysis and Forecast",
            "description": "Comprehensive analysis of the global AI market...",
            "industry_id": 5,
            "industry_name": "Technology",
            "author_id": 12,
            "author_name": "Jane Smith",
            "page_count": 245,
            "published_at": "2024-03-15T10:30:00Z",
            "image": "/assets/reports/ai-market.jpg",
            "rating": 4.8,
            "rating_count": 142,
            "downloads": 856,
            "pricing": {
                "single": 4900,
                "team": 12900,
                "enterprise": 49900
            }
        }
    ],
    "meta": {
        "total": 427,
        "page": 1,
        "per_page": 20,
        "total_pages": 22
    },
    "links": {
        "first": "/v1/reports?page=1",
        "last": "/v1/reports?page=22",
        "next": "/v1/reports?page=2"
    }
}

GET /v1/reports/{slug}

Retrieve detailed information about a specific report.

URL Parameters

Parameter	Description
`slug`	Report slug identifier (URL-safe string)

Response Example

{
    "success": true,
    "data": {
        "id": 1,
        "title": "Global Artificial Intelligence Market",
        "slug": "global-ai-market-2024",
        "subtitle": "2024-2030 Analysis and Forecast",
        "description": "...",
        "page_count": 245,
        "market_size": "$183.7 billion",
        "cagr": "38.5%",
        "forecast_period": "2024-2030",
        "published_at": "2024-03-15T10:30:00Z",
        "industry": {
            "id": 5,
            "name": "Technology",
            "slug": "technology"
        },
        "analyst": {
            "id": 12,
            "name": "Jane Smith",
            "email": "jane@globalmarketreports.com"
        },
        "segments": [
            "Machine Learning",
            "Natural Language Processing",
            "Computer Vision"
        ],
        "regions": [
            "North America",
            "Europe",
            "Asia Pacific"
        ],
        "companies": [
            "OpenAI",
            "Google",
            "Microsoft"
        ],
        "pricing": {
            "single": {"amount": 4900, "currency": "USD"},
            "team": {"amount": 12900, "currency": "USD"},
            "enterprise": {"amount": 49900, "currency": "USD"}
        },
        "faq": [
            {
                "question": "What is included in this report?",
                "answer": "The report includes market overview, competitive landscape, and forecast analysis..."
            }
        ]
    }
}

GET /v1/industries

List all active industry categories with report counts.

Query Parameters

Parameter	Type	Description
`limit`	integer	Maximum industries to return (default 50)

Response Example

{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "Healthcare",
            "slug": "healthcare",
            "description": "Medical devices, pharmaceuticals, and healthcare services",
            "report_count": 45,
            "icon_name": "fa-heartbeat"
        },
        {
            "id": 2,
            "name": "Technology",
            "slug": "technology",
            "description": "Software, hardware, and digital innovation",
            "report_count": 78,
            "icon_name": "fa-laptop"
        }
    ],
    "meta": {
        "total": 32
    }
}

GET /v1/search

Full-text search across all reports with relevance ranking.

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (minimum 2 characters)
`page`	integer	No	Page number (default 1)
`per_page`	integer	No	Results per page (default 20, max 100)

Response Example

{
    "success": true,
    "query": "artificial intelligence",
    "data": [
        {
            "id": 1,
            "title": "Global Artificial Intelligence Market",
            "slug": "global-ai-market-2024",
            "relevance_score": 0.95,
            "snippet": "The global AI market is experiencing rapid growth with a CAGR of 38.5% from 2024 to 2030..."
        }
    ],
    "meta": {
        "total": 12,
        "page": 1,
        "per_page": 20,
        "total_pages": 1
    }
}

Error Handling

The API uses standard HTTP status codes. All errors are returned as JSON with a structured error object.

Error Response Format

{
    "success": false,
    "error": {
        "code": 400,
        "message": "Invalid parameter",
        "details": "The 'page' parameter must be a positive integer"
    }
}

Status Codes

Code	Message	Description
`200`	OK	Request succeeded
`400`	Bad Request	Invalid parameters or malformed request
`401`	Unauthorized	Missing or invalid API key
`403`	Forbidden	API key lacks permissions for the resource
`404`	Not Found	Requested resource doesn't exist
`429`	Too Many Requests	Rate limit exceeded
`500`	Internal Server Error	Server error (retry after a delay)

Code Examples

cURL

# List reports
curl -X GET "https://www.globalmarketreports.com/v1/reports?page=1&per_page=10" \
  -H "Authorization: Bearer gmr_live_your_key_here"

# Get single report
curl -X GET "https://www.globalmarketreports.com/v1/reports/global-ai-market-2024" \
  -H "Authorization: Bearer gmr_live_your_key_here"

# Search reports
curl -X GET "https://www.globalmarketreports.com/v1/search?q=artificial+intelligence&per_page=5" \
  -H "Authorization: Bearer gmr_live_your_key_here"

# List industries
curl -X GET "https://www.globalmarketreports.com/v1/industries" \
  -H "Authorization: Bearer gmr_live_your_key_here"

PHP

 total reports
An error occurred. Please try again later.