# Fincaraiz SEO Metadata API Documentation

Scrappa's `GET /api/fincaraiz/seo-meta` returns the published title, description, canonical URL, keywords, and social image for a Fincaraiz listing, project, or agency page.

**Pass a path, not a full URL.** Supplying an absolute URL does not error — it quietly answers with the site root's metadata instead of the page's, which is the one failure mode on this endpoint worth guarding against. A leading slash is added for you if you omit it.

This is the metadata the platform itself renders, so it matches what a crawler sees on the page.

- **Documentation:** [https://scrappa.co/docs/fincaraiz-api/fincaraiz_seo_meta](https://scrappa.co/docs/fincaraiz-api/fincaraiz_seo_meta)
- **API group:** Fincaraiz API
- **Endpoint:** `GET https://scrappa.co/api/fincaraiz/seo-meta`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `path` | string | Yes | Page path, for example /proyecto/2621770. Do not pass a full URL. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/fincaraiz/seo-meta?path=%2Fproyecto%2F2621770"
```

## Example response

```json
{
    "success": true,
    "path": "/proyecto/2621770",
    "seo_meta": {
        "url": "/proyecto/2621770",
        "title": "OIKOS SAVANNA, Casas en Venta en Cajica",
        "description": "Proyecto de casas en venta en Cajica...",
        "canonical": "/proyecto/2621770",
        "og_image": "https://cdn4.fincaraiz.com.co/web/example.png",
        "noindex": false,
        "site_name": "Fincaraiz"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "seo-meta",
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Upstream Unavailable | The upstream request failed after retries, or returned a response this endpoint cannot read (`upstream_unavailable`, `parser_drift`). Retryable and never billed. |
| 503 | Unreadable Response | The platform answered successfully with a body this endpoint cannot read, so nothing is published and nothing is charged (`parser_drift`). Retryable. |
| 422 | Validation Error | No path was supplied. Non-billable. |
| 404 | No Metadata | The path does not resolve to a page with published metadata (`not_found`). Non-billable. |

## Frequently asked questions

### What happens if I pass a full URL?

It does not error, and that is the problem: you get the site root metadata instead of the page you asked for. Pass the path only.

## Related endpoints

- [Route Resolver](https://scrappa.co/docs/fincaraiz-api/fincaraiz_route_resolver)
- [Project Details](https://scrappa.co/docs/fincaraiz-api/fincaraiz_project)

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)