---
title: "Quote or submit a Research job"
description: "Quote or run a Research job. Set `quote_only: true` to see the price without being charged, then send the same request with its `quote_id` to run it (costs at most 1 credit). Two capabilities are live, each one page and up to 30 results: Facebook company ads by Page ID, and a Meta Ad Library keyword search."
url: https://docs.roasos.com/api-reference/research/createResearchJob
---

# Quote or submit a Research job

Quote or run a Research job. Set `quote_only: true` to see the price without being charged, then send the same request with its `quote_id` to run it (costs at most 1 credit). Two capabilities are live, each one page and up to 30 results: Facebook company ads by Page ID, and a Meta Ad Library keyword search.

## `POST /v1/research/jobs`

Endpoint: `POST https://api.roasos.com/v1/research/jobs`

Quote or submit a Research job

Quote or run a Research job. Set `quote_only: true` to see the price without being charged, then send the same request with its `quote_id` to run it (costs at most 1 credit). Two capabilities are live, each one page and up to 30 results: Facebook company ads by Page ID, and a Meta Ad Library keyword search.

### Parameters

- `undefined`
- `undefined`
- `undefined`

### Request body

Content type: `application/json`

### Responses

- `200`: Immutable quote or free cache-hit job
- `202`: Durably queued live acquisition or free cache join
- `400`: Invalid request, idempotency key, or attribution
- `402`: Insufficient credits
- `403`: Explicit spend approval is required
- `409`: Quote conflict, expiry, or non-terminal retry
- `503`: Quote, billing, projection, or queue authority is unavailable

Read the full reference at https://docs.roasos.com/api-reference/research/createResearchJob.